10A 的GROUP和CUI使用

 

Group结构图

1、group的定义

定义group ID和定义Screen ID一样

在XXX.res 中定义

<SCREEN id="GRP_ID_MYAPP_5"/>//group id

<SCREEN id="GRP_ID_MYAPP_6"/>//group id

<SCREEN id="SCR_ID_MYAPP_5"/>//screen id

                  <SCREEN id="SCR_ID_MYAPP_6"/>//screen id

通过编译资源，系统会自动生成mmi_rp_app_XXX_def.h文件

在mmi_rp_app_XXX_def.h中

我们可以看到如下的定义，这就是我们的group id了，可以看出去group id和screen id 其实是一个东西，只是用法不同而已。

typedef enum

{

    GRP_ID_MYAPP_HEAD = 60382 + 1, /* BASE_ID + 1 */

    GRP_ID_MYAPP_5,

    GRP_ID_MYAPP_6,

    SCR_ID_MYAPP_HEAD,

    SCR_ID_MYAPP_5,

    SCR_ID_MYAPP_6,

    MMI_RP_APP_MYAPP_SCR_MAX

}mmi_rp_app_myapp_scr_enum;

 

       2、group使用

void entry_myapp_screen(void)

{

         MMI_ID parent_id;//定义上级group id

         parent_id=mmi_frm_group_get_active_id();//得到当前激活group id

//将新建的group GRP_ID_MYAPP_HEAD插入到parent_id中

         mmi_frm_group_create(parent_id,

                          GRP_ID_MYAPP_HEAD,

                          mmi_myapp_proc, // mmi_myapp_proc 相当于group的callback函数，

                          NULL);

// mmi_frm_group_enter为进入group函数，具体做了什么以后分析

         mmi_frm_group_enter(GRP_ID_MYAPP_HEAD, MMI_FRM_NODE_SMART_CLOSE_FLAG);

// entry_myapp_show_screen()和group_entry_myapp_show_screen()用于显示菜单的函数

#if 0

         entry_myapp_show_screen();

#else

group_entry_myapp_show_screen();

#endif

}

//所有与group GRP_ID_MYAPP_HEAD相关的操作都会调用mmi_myapp_proc函数，其中

//EVT_ID_CUI_MENU_ITEM_SELECT情况是为CUI提供菜单相应函数

static mmi_ret mmi_myapp_proc(mmi_event_struct *evt)

{

    switch (evt->evt_id)

    {

        case EVT_ID_GROUP_FIRST_ENTRY:myapp_black();break;//第一次进入group时调用

        case EVT_ID_GROUP_INACTIVE:myapp_black(); break;//已经激活时调用

        case EVT_ID_GROUP_ACTIVE:myapp_black();break;//激活时调用

        case EVT_ID_GROUP_GOBACK:myapp_black();break;//调gobackhistory时调用

        case EVT_ID_GROUP_DELETE_REQ:myapp_black(); break;   

        case EVT_ID_GROUP_DEINIT:myapp_black();break;//注销时调用

        case EVT_ID_GROUP_FOCUSED:myapp_black();break;

                      case EVT_ID_CUI_MENU_ITEM_SELECT://为CUI提供菜单高亮相应函数

                            if (menu_evt->highlighted_menu_id == MENU_ID_MYAPP_1)

            {

               myapp_menu1_hight_hdr();

            }

            else if (menu_evt->highlighted_menu_id == MENU_ID_MYAPP_2)

            {

               myapp_menu2_hight_hdr();

            }

else if (menu_evt->highlighted_menu_id == MENU_ID_MYAPP_3)

                              {

                                     myapp_menu3_hight_hdr();

                            }

                                      break;

        default: break;

    }

    return MMI_RET_OK;

}

//使用group就是为了显示窗体的，下面就是显示部分

void group_entry_myapp_show_screen(void)

{

#if 1

                  U8 *guiBuffer;

    U16 nStrItemList[10];

    U16 nNumofItem = 0;

 

    /*----------------------------------------------------------------*/

    /* Code Body                                                      */

    /*----------------------------------------------------------------*/

// mmi_frm_scrn_enter是进入group操作和EntryNewScreen功能差不多

    if (!mmi_frm_scrn_enter(

            GRP_ID_MYAPP_HEAD,//group id

            SCR_ID_MYAPP_HEAD,//screnn id

            NULL,

            group_entry_myapp_show_screen,//入口函数

            MMI_FRM_FULL_SCRN))//全屏显示

    {

        return;

    }

         guiBuffer = mmi_frm_scrn_get_active_gui_buf();//得到屏幕buf

//下面的不是10A的特性就不多说了

         RegisterHighlightHandler(ExecuteCurrHiliteHandler);

         nNumofItem = GetNumOfChild_Ext(MENU_ID_MYAPP_HEAD);

         GetSequenceStringIds_Ext(MENU_ID_MYAPP_HEAD, nStrItemList);

         SetParentHandler(MENU_ID_MYAPP_HEAD);

         ShowCategory15Screen(

        STR_GLOBAL_OPTIONS,

        NULL,

        STR_GLOBAL_OK,

        IMG_GLOBAL_OK,

        STR_GLOBAL_BACK,

        IMG_GLOBAL_BACK,

        nNumofItem,

        nStrItemList,

        (U16*)gIndexIconsImageList,

        LIST_MENU,

        0,

        guiBuffer);

        ClearKeyEvents();

    SetKeyHandler(GoBackHistory, KEY_LEFT_ARROW, KEY_EVENT_DOWN);

    SetRightSoftkeyFunction(GoBackHistory, KEY_EVENT_UP);

#endif

}

3、cui的使用

Cui的用途就是为了方便用户显示菜单，实例如下：

Void entry_myapp_show_screen (void)

{

        mmi_id menu_id;//定义id

    menu_id = cui_menu_create(//创建cui

                GRP_ID_MYAPP_HEAD,//group id

                CUI_MENU_SRC_TYPE_RESOURCE,

                CUI_MENU_TYPE_FROM_RESOURCE,

                MENU_ID_MYAPP_HEAD,// 父菜单ID

                MMI_FALSE,

                (void*) (U32) MENU_ID_MYAPP_HEAD);

    cui_menu_set_default_title(//设置标题及图片

        menu_id,

        (UI_string_type) GetString(STR_GLOBAL_ABORT),

        (UI_image_type) GetImage(IMG_GLOBAL_ACTIVATED));

    cui_menu_run(menu_id);//执行cui

}

entry_myapp_show_screen的整个效果和group_entry_myapp_show_screen一样，我们可以看出entry_myapp_show_screen确实比group_entry_myapp_show_screen简洁了不少这个也是CUI的意义所在，但是同时CUI所显示菜单的高亮相应事件无法通过在.res文件中注册（例如：<MENUITEM

id="MENU_ID_MYAPP_3" str="STR_ID_MYAPP_MENU_3"

highlight="mmi_myapp_menu_3_hdr"/>），CUI所显示的菜单的高亮相应事件要定义在mmi_myapp_proc这种Group创建中所注册的函数中(例如: case EVT_ID_CUI_MENU_ITEM_SELECT: ……..;break;)。