atbwapaui.h

是一个手机功能的模拟程序

/*******************************************************************************

					CONDAT (UK)

********************************************************************************                                                                              

 This software product is the property of Condat (UK) Ltd and may not be
 disclosed to any third party without the express permission of the owner.                                 
                                                                              
********************************************************************************

 $Project name:	                                                      
 $Project code:	                                                           
 $Module:		
 $File:		    ATBWapAUI.h
 $Revision:		                                                      
                                                                              
 $Author:		Condat(UK)                                                         
 $Date:		                                                          
                                                                               
********************************************************************************
                                                                              
 Description:
 	This file...
    
                        
********************************************************************************

 $History: ATBWapAUI.h

	
	   
 $End

*******************************************************************************/
#include "MMiResources.h"

//#include "AUIWap.h"
#if defined(TRACE_ATBWAPAUI) || defined(TRACE_ATBWAPACI)

void ATB_trace_string(char *String, USHORT length);

void ATB_trace_ushort_string(USHORT *String, USHORT length);

#endif
/* SPR#1437 - SH - All display constants stored here, except checkbox sizes
 * which are in wap_types.h */
//zhaowm 2002.1130. changed the value

#define WAP_CHAR_HEIGHT			(LINE_HEIGHT)	//8		// Height of a line of text
#define WAP_CHAR_WIDTH  		8           	//6		// Width of a character
#define WAP_TOTAL_WIDTH			SCREEN_SIZE_X	//84	// Total width of screen
#define WAP_TOTAL_HEIGHT		SCREEN_SIZE_Y	//48	// Total height of screen
#define WAP_LEFT_BORDER			0		// Border at left of screen
#define WAP_RIGHT_BORDER		4		// Border at right of screen
#define WAP_TOP_BORDER			18          	//8		// Border at top of screen (title)
#define WAP_BOTTOM_BORDER		18          	//8		// Border at bottom of screen (softkeys)
#define WAP_SCREEN_RIGHT		(WAP_TOTAL_WIDTH - WAP_RIGHT_BORDER)
#define WAP_SCREEN_BOTTOM		(WAP_TOTAL_HEIGHT - WAP_BOTTOM_BORDER)
#define WAP_SCREEN_WIDTH		(WAP_TOTAL_WIDTH - WAP_LEFT_BORDER - WAP_RIGHT_BORDER)		// No of pixels available to the wap browser in width...
#define WAP_SCREEN_HEIGHT		(WAP_TOTAL_HEIGHT - WAP_TOP_BORDER - WAP_BOTTOM_BORDER)		// and height (not including title & softkeys)
#define WAP_PAGE_SCROLL 		(WAP_SCREEN_HEIGHT-WAP_CHAR_HEIGHT)		// Long scrolling size
#define WAP_TEXT_LOWEST			(WAP_SCREEN_HEIGHT-WAP_CHAR_HEIGHT)	 // Lowest point we can draw text
#define WAP_VSCROLLBAR_WIDTH	3		// Total width of the vertical scrollbar
#define WAP_HSCROLLBAR_WIDTH	4		// Total width of the horizontal scrollbar
#define WAP_SOFTKEY_SPACING	 2			// Minimum spacing between softkey texts
#define WAP_SOFTKEY_MIN_LENGTH 5		// Minimum length for softkey text (including two dots for truncated strings)

/*******************************************************************************

 $Function:    	ATB_wap_start

 $Description:	Starts the WAP application
 
 $Returns:		

 $Arguments:	parameter - a dummy parameter
 
*******************************************************************************/

void ATB_wap_start(T_MMI_WAP_START_IND *parameter);


/*******************************************************************************

 $Function:    	ATB_wap_new_view

 $Description:	Starts a new view, defining the graphical size of the screen to
 				be handled.
 
 $Returns:		Pointer to the data structure of the new view

 $Arguments:	parameter		- width and height of the WAP view
 				UIdata			- Optional generic pointer, for use by the user
 								interface.  This can point to window information, etc,
 								but is not used by ATB.
 
*******************************************************************************/

T_WAP_VIEW* ATB_wap_new_view(T_MMI_WAP_NEW_VIEW_IND *parameter, void* UIdata);


/*******************************************************************************

 $Function:    	ATB_wap_get_view

 $Description:	Returns a pointer to a view, given its object_id
 
 $Returns:		Pointer to the data structure of the specified view

 $Arguments:	object_id  - the id of the view
 
*******************************************************************************/

T_WAP_VIEW* ATB_wap_get_view(UBYTE object_id);


/*******************************************************************************

 $Function:    	ATB_wap_terminate

 $Description:	Closes the WAP application and frees all the memory allocated
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 
*******************************************************************************/

T_WAP_RES ATB_wap_terminate();


/*******************************************************************************

 $Function:    	ATB_wap_destroy_view

 $Description:	Destroys a view
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				
 
*******************************************************************************/

T_WAP_RES ATB_wap_destroy_view(T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_destroy

 $Description:	Destroys the wap application, including all views (calls ATB_wap_terminate)
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				
 
*******************************************************************************/

T_WAP_RES ATB_wap_destroy();


/*******************************************************************************

 $Function:    	ATB_wap_UIdata

 $Description:	Returns the UI pointer, for use by AUI
 
 $Returns:		The void pointer

 $Arguments:	
 				
 
*******************************************************************************/

void *ATB_wap_UIdata();


/*******************************************************************************

 $Function:    	ATB_wap_configure

 $Description:	Sends configuration information to the browser, the more important being:
 				- ConfigHISTORY_SIZE, the number of URLs stored in the history
 				- ConfigCACHE_AGE, period for the cache to store a card
 				- ConfigDISPLAY_IMAGES, images to be displayed or not
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				Configure		- Properties of configuration
 
*******************************************************************************/

T_WAP_RES ATB_wap_configure(T_MMI_WAP_CONFIGURE_IND *Configure);


/*******************************************************************************

 $Function:    	ATB_wap_connection_configure

 $Description:	Sends network configuration information to the browser, such as the
 				bearer, IP addresses, passwords and ids, etc.
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	objectId				- Identifier of the session
 				Connection				- Properties of configuration
 
*******************************************************************************/

T_WAP_RES ATB_wap_connection_configure(T_MMI_WAP_CONNECTION_CONFIGURE_IND *Connection);


/*******************************************************************************

 $Function:    	ATB_wap_download_url

 $Description:	Requests the WAP browser to download a particular URL
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				DownloadURL		- Properties of the URL download
 
*******************************************************************************/

T_WAP_RES ATB_wap_download_url(T_MMI_WAP_DOWNLOAD_URL_IND *DownloadURL);

/*******************************************************************************

 $Function:    	ATB_wap_stop_download

 $Description:	Requests the WAP browser to stop downloading a particular URL
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	View - the current view
 
*******************************************************************************/

T_WAP_RES ATB_wap_stop_download(T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_card_refresh

 $Description:	Requests the WAP browser to refresh the current card from the network
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 
*******************************************************************************/

T_WAP_RES ATB_wap_card_refresh(T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_card_display

 $Description:	Requests the WAP browser to redisplay a card held in the cache
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	View - the current view
 
*******************************************************************************/

T_WAP_RES ATB_wap_card_display(T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_card_go_back

 $Description:	Requests the WAP browser to go to the previous card
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	View - the current view
 
*******************************************************************************/

T_WAP_RES ATB_wap_card_go_back(T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_card_key_event

 $Description:	Requests the WAP browser react to a key event, up/down etc.
 
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	View - the current view
 
*******************************************************************************/

T_WAP_RES ATB_wap_card_key_event(T_WAP_VIEW *View, WAP_CONTROL_TYPES keyType);


/*******************************************************************************

 $Function:    	ATB_wap_key_selected

 $Description:	Send the id of the selected WAP key to the AUS browser.
 				
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	View - the current view
 				keyId - Key identifier
 
*******************************************************************************/

T_WAP_RES ATB_wap_key_selected(T_WAP_VIEW *View, USHORT keyId);


/*******************************************************************************

 $Function:    	ATB_wap_card scroll

 $Description:	Scroll to a y position on the current card
 				
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	scrollPos			- Y position on card to which to scroll
 
*******************************************************************************/

T_WAP_RES ATB_wap_card_scroll(T_WAP_VIEW *View, SHORT scrollPos);


/*******************************************************************************

 $Function:    	AUI_wap_input_dialog_open

 $Description:	Prompts the MMI to open an input dialog given a particular format and
 				string.
 				
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	Dialog			- Dialog information
 				View			- The current view
 
*******************************************************************************/

T_WAP_RES AUI_wap_input_dialog_open(T_WAP_MMI_INPUT_DIALOG_REQ *Dialog, T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_input_dialog_closed

 $Description:	Provides the answer of an input dialog.
 				
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				DialogCnf		- Dialog confirmation information
 
*******************************************************************************/


T_WAP_RES ATB_wap_input_dialog_closed(T_MMI_WAP_INPUT_DIALOG_CNF *DialogCnf);


/*******************************************************************************

 $Function:    	AUI_wap_password_dialog_open

 $Description:	Prompts the MMI to open a password dialog.
 				
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				Dialog			- Dialog information
 
*******************************************************************************/

T_WAP_RES AUI_wap_password_dialog_open(T_WAP_MMI_PASSWORD_DIALOG_REQ *Dialog,T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_password_dialog_closed

 $Description:	Provides the answer of a password dialog.
 				
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				DialogCnf		- Dialog confirmation information
 
*******************************************************************************/

T_WAP_RES ATB_wap_password_dialog_closed(T_MMI_WAP_PASSWORD_DIALOG_CNF *DialogCnf);


/*******************************************************************************

 $Function:    	AUI_wap_confirm_dialog_open

 $Description:	Prompts the MMI to open a confirmation dialog.
 				
 $Returns:		WAP_OK if successful, WAP_FAIL if otherwise

 $Arguments:	
 				Dialog			- Dialog information
 
*******************************************************************************/

T_WAP_RES AUI_wap_confirm_dialog_open(T_WAP_MMI_CONFIRM_DIALOG_REQ *Dialog, T_WAP_VIEW *View);


/*******************************************************************************

 $Function:    	ATB_wap_confirm_dialog_closed