addrbookruim.c

BREW程序：对SIM/UIM卡的电话地址本进行操作

/*===========================================================================

FILE: addrbookruim.c
ABR: Address Book on Ruim
===========================================================================*/


/*===============================================================================
INCLUDES AND VARIABLE DEFINITIONS
=============================================================================== */
#include "AEEModGen.h"          // Module interface definitions
#include "AEEAppGen.h"          // Applet interface definitions
#include "AEEShell.h"           // Shell interface definitions
#include "AEEStdLib.h"
#include "AEEKeysConfig.h"
#include "AEEAddrbook.h"

#include "addrbookruim.h"
#include "addrbookruim.bid"
#include "addrbookruim.brh"
#include "abr_function.h"


/*-------------------------------------------------------------------
Function Prototypes
-------------------------------------------------------------------*/
static  boolean ABR_HandleEvent(CAddrBookRuim* pMe, AEEEvent eCode, 
                                             uint16 wParam, uint32 dwParam);
boolean ABR_InitAppData(CAddrBookRuim* pMe);
static boolean ABR_CreateMainControls(CAddrBookRuim* pMe);

void    ABR_FreeAppData(CAddrBookRuim* pMe);
static void ABR_ReleaseMainControls(CAddrBookRuim* pMe);
static void ReleaseObj(void ** ppObj);
static void ABR_DisplayMainMenu( CAddrBookRuim* pMe );
static void ABR_DisplayAddScreen( CAddrBookRuim* pMe );
static void ABR_DisplayViewMenu( CAddrBookRuim* pMe );
static void ABR_DisplayEditScreen( CAddrBookRuim* pMe, uint16 wItemID );
static void ABR_DisplayTotalRec( CAddrBookRuim* pMe );
static void ABR_DisplayStoreDevice( CAddrBookRuim* pMe );

static void ABR_Reset(CAddrBookRuim * pMe );

/*===============================================================================
FUNCTION DEFINITIONS
=============================================================================== */

/*===========================================================================
FUNCTION: AEEClsCreateInstance

DESCRIPTION
  This function is invoked while the app is being loaded. All Modules must provide this 
  function. Ensure to retain the same name and parameters for this function.
  In here, the module must verify the ClassID and then invoke the AEEApplet_New() function
  that has been provided in AEEAppGen.c. 

   After invoking AEEApplet_New(), this function can do app specific initialization. In this
   example, a generic structure is provided so that app developers need not change app specific
   initialization section every time except for a call to IDisplay_InitAppData(). 
   This is done as follows: InitAppData() is called to initialize AppletData 
   instance. It is app developers responsibility to fill-in app data initialization 
   code of InitAppData(). App developer is also responsible to release memory 
   allocated for data contained in AppletData -- this can be done in 
   IDisplay_FreeAppData().

PROTOTYPE:
   int AEEClsCreateInstance(AEECLSID ClsId,IShell * pIShell,IModule * po,void ** ppObj)

PARAMETERS:
  clsID: [in]: Specifies the ClassID of the applet which is being loaded

  pIShell: [in]: Contains pointer to the IShell object. 

  pIModule: pin]: Contains pointer to the IModule object to the current module to which
  this app belongs

  ppObj: [out]: On return, *ppObj must point to a valid IApplet structure. Allocation
  of memory for this structure and initializing the base data members is done by AEEApplet_New().

DEPENDENCIES
  none

RETURN VALUE
  AEE_SUCCESS: If the app needs to be loaded and if AEEApplet_New() invocation was
     successful
  EFAILED: If the app does not need to be loaded or if errors occurred in 
     AEEApplet_New(). If this function returns FALSE, the app will not be loaded.

SIDE EFFECTS
  none
===========================================================================*/
int AEEClsCreateInstance(AEECLSID ClsId, IShell *pIShell, IModule *po, void **ppObj)
{
  *ppObj = NULL;

  if( ClsId == AEECLSID_ADDRBOOKRUIM )
  {
    // Create the applet and make room for the applet structure
    if( AEEApplet_New(sizeof(CAddrBookRuim),
                      ClsId,
                      pIShell,
                      po,
                      (IApplet**)ppObj,
                      (AEEHANDLER)ABR_HandleEvent,
                      (PFNFREEAPPDATA)ABR_FreeAppData) ) // the FreeAppData function is called after sending EVT_APP_STOP to the HandleEvent function
                          
    {
      //Initialize applet data, this is called before sending EVT_APP_START
      // to the HandleEvent function
      if(ABR_InitAppData((CAddrBookRuim*)*ppObj))
      {
        //Data initialized successfully
        return(AEE_SUCCESS);
      }
      else
      {
        //Release the applet. This will free the memory allocated for the applet when
        // AEEApplet_New was called.
        IAPPLET_Release((IApplet*)*ppObj);
        return EFAILED;
      }

    } // end AEEApplet_New

  }

  return(EFAILED);
}


// this function is called when your application is starting up
boolean ABR_InitAppData(CAddrBookRuim* pMe)
{
    // Get the device information for this handset.
    // Reference all the data by looking at the pMe->DeviceInfo structure
    // Check the API reference guide for all the handy device info you can get
    pMe->DeviceInfo.wStructSize = sizeof(pMe->DeviceInfo);
    ISHELL_GetDeviceInfo(pMe->a.m_pIShell,&pMe->DeviceInfo);

    // The display and shell interfaces are always created by
    // default, so we'll asign them so that you can access
    // them via the standard "pMe->" without the "a."
    pMe->pIDisplay = pMe->a.m_pIDisplay;
    pMe->pIShell   = pMe->a.m_pIShell;

    // Insert your code here for initializing or allocating resources...

    // Create all of the common GUI controls that will be used for all
    // interfaces except the Add/Edit and View dialogs (these will be 
    // created and deleted as needed).
    if(!ABR_CreateMainControls(pMe))
    {
      return FALSE;
    }
    pMe->m_nFontHeight = IDISPLAY_GetFontMetrics( pMe->pIDisplay, AEE_FONT_NORMAL, NULL, NULL ) + 1;

    SETAEERECT( &pMe->m_rScreenRect, 0, 0, pMe->DeviceInfo.cxScreen, pMe->DeviceInfo.cyScreen);
    pMe->m_ContactCLS = AEECLSID_ADDRBOOK_RUIM;
    // if there have been no failures up to this point then return success
    return TRUE;
}

/*===========================================================================

FUNCTION: ABR_CreateMainControls

DESCRIPTION:
  Creates controls used by the applet

PARAMETERS:
  pMe [in] - Pointer to the CAddrBookRuim structure. This structure contains 
    information specific to this applet. 

DEPENDENCIES:
   Assumes pMe is not NULL

RETURN VALUE:
   TRUE - Controls created successfully
   FALSE - Control creation failed

SIDE EFFECTS:
   None
===========================================================================*/
static boolean ABR_CreateMainControls( CAddrBookRuim* pMe )
{
   AEERect rc;
   AEEItemStyle rNormalStyle;
   AEEItemStyle rSelStyle;

   // Create the main application controls.
   if((ISHELL_CreateInstance(pMe->pIShell, AEECLSID_MENUCTL, (void**)(&pMe->m_pMenu)) != SUCCESS) ||
      (ISHELL_CreateInstance(pMe->pIShell, AEECLSID_SOFTKEYCTL, (void**)(&pMe->m_pSK)) != SUCCESS) ||
      (ISHELL_CreateInstance(pMe->pIShell, AEECLSID_TEXTCTL, (void**)(&pMe->m_pText1)) != SUCCESS) ||
      (ISHELL_CreateInstance(pMe->pIShell, AEECLSID_TEXTCTL, (void**)(&pMe->m_pText2)) != SUCCESS ))
      return FALSE;

  // Let's reset text control size so on subsequent this won't misbehave by erasing screen
  SETAEERECT(&rc, 0, 0, 0, 0);
  ITEXTCTL_SetRect(pMe->m_pText1, &rc);
  ITEXTCTL_SetRect(pMe->m_pText2, &rc);

  // Set the style of the menu control so that all the icons are displayed as
  // transparent.  This is set based on the default menu styles.
  ISHELL_GetItemStyle( pMe->pIShell, AEE_IT_MENU, &rNormalStyle, &rSelStyle );
  rNormalStyle.roImage = AEE_RO_TRANSPARENT;
  rSelStyle.roImage = AEE_RO_TRANSPARENT;
  IMENUCTL_SetStyle( pMe->m_pMenu, &rNormalStyle, &rSelStyle );

  return TRUE;
}

// this function is called when your application is exiting
void ABR_FreeAppData(CAddrBookRuim* pMe)
{
    // insert your code here for freeing any resources you have allocated...

    // example to use for releasing each interface:
    // if ( pMe->pIMenuCtl != NULL )         // check for NULL first
    // {
    //    IMENUCTL_Release(pMe->pIMenuCtl)   // release the interface
    //    pMe->pIMenuCtl = NULL;             // set to NULL so no problems trying to free later
    // }
    //
   // Release each of the  common controls.
   ABR_ReleaseMainControls(pMe);

}

/*===========================================================================

FUNCTION: ABR_ReleaseMainControls

DESCRIPTION:
  Frees each of the controls used by the application.

PARAMETERS:
  pMe [in] - Applet Structure

DEPENDENCIES:
   Assumes pMe is not NULL

RETURN VALUE:
   None

SIDE EFFECTS:
   None
===========================================================================*/
static void ABR_ReleaseMainControls(CAddrBookRuim* pMe)
{   
   // Release each of the controls
   ReleaseObj((void**)&pMe->m_pMenu);
   ReleaseObj((void**)&pMe->m_pSK);
   ReleaseObj((void**)&pMe->m_pText1);
   ReleaseObj((void**)&pMe->m_pText2);
}

/*===========================================================================

FUNCTION: ReleaseObj

DESCRIPTION:
  This is a convenience function which releases BREW controls.  It also
  checks that the pointer is not NULL before attempting to release the
  control.

PARAMETERS:
  ReleaseObj [in/out] - Pointer to the data pointer of the control.

DEPENDENCIES:
   None

RETURN VALUE:
   None

SIDE EFFECTS:
   None
===========================================================================*/
static void ReleaseObj(void ** ppObj)
{
    if ( ppObj && *ppObj ) 
    {
        (void)IBASE_Release(((IBase *)*ppObj));
        *ppObj = NULL;
    }
}

/*===========================================================================
FUNCTION SampleAppWizard_HandleEvent

DESCRIPTION
  This is the EventHandler for this app. All events to this app are handled in this
  function. All APPs must supply an Event Handler.

PROTOTYPE:
  boolean SampleAppWizard_HandleEvent(IApplet * pi, AEEEvent eCode, uint16 wParam, uint32 dwParam)

PARAMETERS:
  pi: Pointer to the AEEApplet structure. This structure contains information specific
  to this applet. It was initialized during the AEEClsCreateInstance() function.

  ecode: Specifies the Event sent to this applet

   wParam, dwParam: Event specific data.

DEPENDENCIES
  none

RETURN VALUE
  TRUE: If the app has processed the event
  FALSE: If the app did not process the event

SIDE EFFECTS
  none
===========================================================================*/
static boolean ABR_HandleEvent(CAddrBookRuim* pMe, AEEEvent eCode, uint16 wParam, uint32 dwParam)
{  
    const uint16 wButtonIDs[] = {IDC_OK_PROMPT, 0};
    int32 nRet;
    AEEPromptInfo pInfo;
    uint16 wTextID;