一个完整的MMI程序的定义与实现(你值得一看)

一个MMI应用程序应该包含以下步骤：

1：一个初始化函数去注册不同的event handlers；

2：Highlight handlers 进行函数注册主要是选中菜单后调用该注册函数，即该菜单对应的操作；

3：完成入口函数Entry functions

4：完成退出函数Exit functions

5：完成business logic 去进行不同entry functions 之间的引用。

MMI 采用screen流的方式进行屏幕之间的转换，进入新的screen之前，执行被覆盖screen的exit函数，并将相关信息存入历史记录，然后进入新的screen, 从新的screen退出后从history数据库取出上一screen的信息，进入其entry函数。

以下代码片段的API都是系统提供的，可在头文件中找到其原形。

一：初始化函数代码片段：

//以下两个API参考eventGprot.h

V oid MyInitialization(void)

{

//设事件处理函数如下闹钟超时处理时间

SetProtocolEventHandler(AlmExpiryHandler,

MSG_ID_MMI_EQ_ALARM_IND);

//设置Highlight Handler函数当点mms菜单后调用相应函数HighlightMMSHandler

SetHiliteHandler (MESSAGES_MENU_MMS_MENUID, HighlightMMSHandler);

}

二：入口函数代码片段：

// 本例为进入短信主菜单的处理函数相关接口函数可在对应的头文件中查找void EntrySMSMainMenuList (void)

{

U8* guiBuffer;

U16 nStrItemList[MAX_SUB_MENUS];

U16 numItems;

U16 i temIcons[MAX_SUB_MENUS];

U8* p opUpList[MAX_SUB_MENUS];

U32 menuItemId=-1;

U32 menuItemId1=-1;

U32 maskingByte=-1;

U8** pPopUpList=NULL;

//进入入口函数必须首先调用EntryNewScreen, 该函数执行上一屏幕的退出函数，并记录当前屏幕的入口和退出函数

EntryNewScreen(SCR_ID_MSG_SMS_MAIN_MENU, mmi_msg_exit_generic, EntrySMSMainMenuList, NULL);

//设置当前screen ID

SetMessagesCurrScrnID(SCR_ID_MSG_SMS_MAIN_MENU);

//获取当前screen 的gui buffer，用于被当前screen被覆盖后存入历史记录guiBuffer = GetCurrGuiBuffer (SCR_ID_MSG_SMS_MAIN_MENU);

//设置当前screen的父menu ID

SetParentHandler (MESSAGES_MENU_SMS_MENUID);

//注册Highlighthandler处理函数

RegisterHighlightHandler (ExecuteCurrHiliteHandler);

//获取当前菜单子菜单数目

numItems = GetNumOfChild (MESSAGES_MENU_SMS_MENUID);

//获取子菜单的string

GetSequenceStringIds(MESSAGES_MENU_SMS_MENUID, nStrItemList);

//获取子菜单Icon

GetSequenceImageIds(MESSAGES_MENU_SMS_MENUID, itemIcons);

mmi_msg_set_msg_num_hint (msgbox_info.totalinbox, msgbox_info.totaloutbox, msgbox_info.totaldraftbox);

ConstructHintsList(MESSAGES_MENU_SMS_MENUID, popUpList);

mmi_msg_set_msg_menu_highlight_handler();

if (g_msg_cntx.msg_init)

{

pPopUpList = popUpList;

else

{

pPopUpList = NULL;

}

menuItemId=GetChildMenuIDIndexByParentMenuID(MESSAGES_MENU_SM S_MENUID, MESSAGES_MENU_INBOX_MENUID);

if(menuItemId!=-1)

{

if(IsResetCSPGroupService(CSP_TELESERVICES_SERVICE_GROUP,CSP_S M_MT))

{

ResetBit(maskingByte,menuItemId/*1*/);

}

}

menuItemId=GetChildMenuIDIndexByParentMenuID(MESSAGES_MENU_SM S_MENUID, MESSAGES_MENU_WMESSAGE_MENU_ID);

menuItemId1=GetChildMenuIDIndexByParentMenuID(MESSAGES_MENU_S MS_MENUID, MESSAGES_MENU_OUTBOX_MENUID);

if(menuItemId!=-1 && menuItemId1!=-1)

{

if(IsResetCSPGroupService(CSP_TELESERVICES_SERVICE_GROUP,CSP_S M_MO))

{

ResetBit(maskingByte, menuItemId/*0*/);

ResetBit(maskingByte,menuItemId1/*2*/);

}

}

menuItemId=GetChildMenuIDIndexByParentMenuID(MESSAGES_MENU_SM S_MENUID, MESSAGES_MENU_CB_MENUID);

if(menuItemId!=-1)

{

if(IsResetCSPGroupService(CSP_TELESERVICES_SERVICE_GROUP,CSP_S M_CB))

ResetBit(maskingByte,menuItemId/*6*/);

}

menuItemId=GetChildMenuIDIndexByParentMenuID(MESSAGES_MENU_SM S_MENUID, MESSAGES_MENU_VMAIL_MENUID);

if(menuItemId!=-1)

{

if(IsResetCSPGroupService(CSP_V ALUE_ADDED_SERVICES_SERVICE_GR OUP,CSP_VPS))

ResetBit(maskingByte,menuItemId/*5*/);

MaskStringItems(popUpList,(U8)numItems,maskingByte);

MaskItems(itemIcons,(U8)numItems,maskingByte);

numItems=MaskItems(nStrItemList,(U8)numItems,maskingByte);

MaskHiliteItems(MAIN_MENU_MESSAGES_MENUID, maskingByte);

g_msg_cntx.currBoxIndex=0;

// show category 函数，将上面准备好的参数传递进去，show当前screen ，show category系统已经提供了足够多风格的函数选择，可根据需要调用对应的showcategory函数（在ProjectName/Doc/Doc.rar/CATEGORY中查看各种show category相应的屏幕模板）.

ShowCategory52Screen(STR_SMS_MENUENTRY,

IMG_SMS_ENTRY_SCRN_CAPTION,

STR_GLOBAL_OK,

IMG_SMS_COMMON_NOIMAGE,

STR_GLOBAL_BACK,

IMG_SMS_COMMON_NOIMAGE,

numItems,

nStrItemList, itemIcons,

(U8 **) pPopUpList ,

0, 0,

guiBuffer );

//注册右软件处理函数返回键

SetRightSoftkeyFunction (GoBackHistory, KEY_EVENT_UP);

//同上

SetKeyHandler (GoBackHistory, KEY_LEFT_ARROW, KEY_EVENT_DOWN);

}

三：退出代码函数片段：

退出函数在进入函数的EntryNewScreen中第二个参数被注册，进入当前screen 时执行上一个screen的exit函数。

V oid ExitFunction(void)

{

//定义history变量

History Scr8500;

//记录将要被存入history 的screen id

Scr8500.scrnID = SCR8500_CALL_LISTMEU;

//记录当前screen的入口函数，将来被恢复是将被调用

Scr8500.entryFuncPtr = EntryScrCallMenuList;

//复制要存储的任何用户数据

Strcpy(Scr8500.inputBuffer, “…..”);

//store the screen attributes in the gui buffer

GetCategoryHistory(Scr8500.guiBuffer);

//加入到history数据库

AddHistory(Scr8500);

}

四：进入MMS菜单细节

以下为进入MMS菜单前准备流程：

//菜单ID与处理函数对应，当user选中MESSAGES_MENU_MMS_MENUID后执行HighlightMMSHandler函数。

SetHiliteHandler (MESSAGES_MENU_MMS_MENUID, HighlightMMSHandler); // HighlightMMSHandler函数原形

void HighlightMMSHandler (void)

{

//改变左软件string 和icon

ChangeLeftSoftkey (STR_GLOBAL_OK, IMG_SMS_COMMON_NOIMAGE);

//改变右软件string 和icon

ChangeRightSoftkey (STR_GLOBAL_BACK, IMG_SMS_COMMON_NOIMAGE);

//为左软件注册处理函数，当user选中左软件，则进入EntryScrMMSMenuList 函数, 即开始mms主菜单的显示

SetLeftSoftkeyFunction (EntryScrMMSMenuList, KEY_EVENT_UP);

//同上右方向按下进入EntryScrMMSMenuList

SetKeyHandler (EntryScrMMSMenuList, KEY_RIGHT_ARROW, KEY_EVENT_DOWN);

}