MTK高亮机制

 

修改人	版本号	变更说明	修改日期
	V1.0	Init	2009-12-26

 

 

 

MTK高亮机制

1     介绍：... 3

2     相关函数和变量列表：... 3

3     高亮机制说明：... 5

4     相关知识点说明：... 7

 

 

1          介绍：

本文旨在介绍MTK平台高亮机制的处理逻辑，相信能对刚入手MTK平台的同学有一定帮助，也能给平时为了项目进度和其他原因，对MTK的这些基本常识不求甚解，只能依葫芦画瓢的添加菜单和处理函数的同学一个警醒和帮助，能主动去深入了解问题和提高自己。

本人从事MTK的时间也不长，上面的话有些托大，对新手还是说得过去的。文档中有些地方不正确和清楚的，欢迎评论和讨论。

 

 

2          相关函数和变量列表：

void RegisterHighlightHandler(void (*f) (S32 item_index))

注册窗口的通用高亮处理函数。

MMI_list_highlight_handler

通用高亮处理函数的全局变量指针。

 

void ExecuteCurrHiliteHandler(S32 hiliteid)

当前高亮菜单项的通用处理函数，它会找到菜单项对应的处理函数。一般在窗口创建过程中被创建RegisterHighlightHandler(ExecuteCurrHiliteHandler)。

 

FuncPtr mmi_frm_get_hilite_hdlr(U16 menu_id)

获取menu_id对应的菜单高亮函数，从两个函数指针数组里获取。先查找动态菜单的高亮函数指针数组，这个是在程序中动态添加的数组；如果找不到，再到静态数组里查找，这个数组是在编译过程中生成的，通常我们在res_mainmenu.c等函数里增加的菜单会被资源生成工具编译成一个静态数组。

mmi_frm_int_hilite_hdlr_table[]  动态数组。

mmi_frm_const_hilite_hdlr_table[]  静态数组。

 

currParentID

当前父窗口全局变量

 

void SetHiliteHandler(U16 itemid, FuncPtr hiliteFuncPtr)

设置动态高亮数组的MENUID及它相对应的处理函数，一般用在自定义的菜单项。比如在图片浏览、JAVA应用、WAP记录等不可预期菜单项数目的环境，我们不可能做静态的MENUID和处理函数，就需要用到动态的实现方式。

hintData[][]

[待确认]：这是一个动态菜单的数据缓冲，和MENUID一一对应。通俗一点说，就是菜单的显示字符串。网上有文章对此以及ConstructHintsList（）理解应该有误，主要是因为代码里该函数注释说是处理静态的，应该是注释错了。引用一段描述：

3 、ConstructHintsList()   

Constructs Hint List for a static menu screen 

void ConstructHintsList(U16 parentID, U8 **hintArray)
{      。。。。。。

(*maxHiliteInfo[hiliteItemID[i]].hintFuncPtr) (idx);//SetHintHandler注册的函数的函数在此被执行
                hintArray[idx] = hintData[idx];//该语句是该函数的核心，就是将全局变量hintData[idx]数组地址

                                                            //赋给用户传过来的指针数组；至于hintData[idx]中是否有数据不

                                                            //管；hintData[idx]的数据会在调用SetHintHandler注册的函数时对其

                                                           //进行初始化；要记住SetHintHandler注册的函数在SetHiliteHandler注册的

                                                           //函数之前执行。

    我认为ConstructHintsList（）是创建动态菜单的，时间关系，待分析。

 

3          高亮机制说明：

3.1       使用流程

每个窗口进入后基本都有类似下面的一段程序：

    。。。。。。

    EntryNewScreen(EM_DEBUG_INFO_SCR, NULL, EntryEMDebugInfo, NULL);

 

    guiBuffer = GetCurrGuiBuffer(EM_DEBUG_INFO_SCR);

    nItems = GetNumOfChild(EM_DEBUG_INFO_MENUID);

    GetSequenceStringIds(EM_DEBUG_INFO_MENUID, ItemList);

    SetParentHandler(EM_DEBUG_INFO_MENUID);

    RegisterHighlightHandler(ExecuteCurrHiliteHandler);

ShowCategory52Screen(。。。)

SetRightSoftkeyFunction(GoBackHistory, KEY_EVENT_UP);

。。。。。。

3.2       分析

这是窗口建立过程的一个通用处理结构，这里简单说明一下，每个函数的具体实现和功能请阅读代码。

EntryNewScreen初始化建立一个窗口需要的变量和过程，并退出上一个窗口，清除按键处理函数等；

SetParentHandler很重要，设置当前父窗口全局变量的MENUID，用来定位到当前是在哪一个窗口，后面依据他来在菜单树中查找到高亮的菜单项的MENUID，找到菜单项的MENUID后，通过mmi_frm_get_hilite_hdlr(U16 menu_id)可以找到菜单项对应的高亮函数；RegisterHighlightHandler把ExecuteCurrHiliteHandler注册成一个通用的高亮处理函数，我们只要告诉ExecuteCurrHiliteHandler当前高亮的菜单项的MENUID，它就能找到执行函数并开始执行了。到这里就应该已经基本明白了高亮机制了，弄明白了其实也很简单的 ^_^ ；

ShowCategory52Screen（）只是一个窗口界面绘制函数，和事件处理逻辑没有关系。

SetRightSoftkeyFunction(GoBackHistory, KEY_EVENT_UP)等函数设置这个窗口要响应哪些按键事件，并设置好相应的处理函数。

 

3.3       高亮函数触发过程

RegisterHighlightHandler把ExecuteCurrHiliteHandler注册成一个通用的高亮处理函数，实际上是给MMI_list_highlight_handler函数指针赋值。触发则需要调用MMI_list_highlight_handler。

由于MTK平台支持各种菜单形式，比如纯文本的菜单、带CHECKBOX的、带RADIO的、带一个图片的、带两个图片的、两行的。我们现在只对一种标准菜单进行分析，其他形式的分析方法相同。

standard_list_highlight_handler(S32 item_index)里会执行注册的高亮处理函数MMI_list_highlight_handler，而standard_list_highlight_handler本身又是一个注册函数，在wgui_fixed_list_create_text_menu()里会被注册到MMI_fixed_list_menu.item_highlighted，MMI_fixed_list_menu是菜单组件的数据结构，包含有菜单组件从显示到功能处理函数的所有数据，具体每个组件怎么被显示，怎么响应功能按键就不在这里讨论了，后续我可能会写出文档，有兴趣的同学自己看代码，效果会更好。

这里简单说一下，MMI_fixed_list_menu.item_highlighted在这个组件里，会被gui_fixed_list_menu_switch_highlighted_item（）函数来执行，而gui_fixed_list_menu_switch_highlighted_item（）则在上下按键执行的时候被执行，比响应上按键的函数是void fixed_list_goto_previous_item(void)，它调用void gui_fixed_list_menu_goto_previous_item(fixed_list_menu *m)，而void gui_fixed_list_menu_goto_previous_item(fixed_list_menu *m)则调用gui_fixed_list_menu_switch_highlighted_item（），整个触发过程就完成了。

关于上下按键的注册，则在wgui_fixed_list_create_text_menu()里有：

        if (flag & WGUI_LIST_MENU_DISABLE_VOL_KEY)

            register_fixed_list_keys_ex();

        else

            register_fixed_list_keys();

来注册按键事件处理函数，其实现过程很简单：

void register_fixed_list_keys(void)

{

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

    /* Local Variables                                                */

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

 

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

    /* Code Body                                                      */

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

    SetKeyHandler(fixed_list_goto_previous_item, KEY_UP_ARROW, KEY_EVENT_DOWN);

    SetKeyHandler(fixed_list_goto_next_item, KEY_DOWN_ARROW, KEY_EVENT_DOWN);

    SetKeyHandler(fixed_list_goto_previous_item, KEY_VOL_UP, KEY_EVENT_DOWN);

    SetKeyHandler(fixed_list_goto_next_item, KEY_VOL_DOWN, KEY_EVENT_DOWN);

}

 

    关于如何实现按键事件的响应、按键的处理逻辑，又是一个专题了。大致包括键盘中断、去抖、键盘映射、检测、进程通信、应用部分按键处理机制等，有机会再写出文档。

 

 

4          相关知识点说明：

4.1       初始化相关

 

高亮的一些全局变量会在InitEvents()里进行初始化，在event.c文件里。这个函数在开机过程中的一个调用栈关系如下：

InitEvents();

InitEventHandlersBeforePowerOn();

void MMI_task(oslEntryType *entry_param)

 

InitEvents();还会在InitFramework（）中被调用，而InitFramework（）会由于开机的状态不同，如USB开机、闹钟开机等，调用流程也不尽相同。具体的可参见我的另一篇应用开机流程的文档。

 

4.2  菜单结构及查找

4.2.1  菜单数数组示意

const CUSTOM_MENU        mtk_nCustMenus[]={

{1,0,18,0,16,2,10933,11062,(U16 *)nOrderMenuItem_0},

{2,0,3,1,0,1,26218,26085,(U16 *)nOrderMenuItem_1},

{3,2,0,1,0,1,555,0,(U16 *)0},

{4,2,0,1,0,1,552,0,(U16 *)0},

{5,2,0,1,0,1,26173,0,(U16 *)0},

{0,0,0,0,0,0,0,0,(U16 *)0},

{0,0,0,0,0,0,0,0,(U16 *)0},

{0,0,0,0,0,0,0,0,(U16 *)0},

{0,0,0,0,0,0,0,0,(U16 *)0},

{0,0,0,0,0,0,0,0,(U16 *)0},

{0,0,0,0,0,0,0,0,(U16 *)0},

。。。。。。。。

}

 

CUSTOM_MENU         nCustMenus[MAX_MENU_ITEMS];

 

4.2.2  通过父窗口MENUID及高亮INDEX找到高亮窗口MENUID

U16 GetSeqItemId_Ext(U16 parent_item_id, U16 index)

{

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

    /* Local Variables                                                */

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

    U8 i = 0, idx = 0;

    U16 item_id = 0;

    U8 child_count = (U8) nCustMenus[parent_item_id - 1].nNumofMenuItem;

 

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

    /* Code Body                                                      */

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

#ifdef DEVAPP_RESOURCE

    if ( parent_item_id >= MENU_ID_DEVAPP_START )

    {

        return DevAppGetSeqItemId_Ext(parent_item_id, index);

    }

#endif

 

    for (i = 0; i < child_count; i++)

    {

        item_id = nCustMenus[parent_item_id - 1].nOrderMenuItemId[i];

        if (!mmi_frm_test_menu_item_hide(item_id))  /* the item is not hidden */

        {

            if (idx == index)

            {

                break;

            }

            else

            {

                idx++;

            }

        }

    }

    MMI_TRACE(MMI_FW_TRC_G2_GUI, MMI_RESGEN_ALL_MENU_HIDE, parent_item_id);

    return item_id;

}

 

 

4．2.3  通过高亮窗口MENUID找到对应的高亮函数

FuncPtr mmi_frm_get_hilite_hdlr(U16 menu_id)

{

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

    /* Local Variables                                                */

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

    U32 index;

 

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

    /* Code Body                                                      */

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

           

    /* Firstly search the dynamic table */

    if (mmi_frm_binary_search((U32)menu_id, (mmi_frm_pair_data_struct*)mmi_frm_int_hilite_hdlr_table,

                                   (U32)mmi_frm_int_hilite_hdlr_count, &index))

    {

        return mmi_frm_int_hilite_hdlr_table[index].hilite_hdlr;

    }

    /* And then search the constant table. The constant table is generanted by resgen. */

    else if (mmi_frm_binary_search((U32)menu_id,

             (mmi_frm_pair_data_struct*)mmi_frm_const_hilite_hdlr_table,

             (U32)ARRAY_COUNT(mmi_frm_const_hilite_hdlr_table), &index))

    {

        return mmi_frm_const_hilite_hdlr_table[index].hilite_hdlr;

    }

    else

    {

        return NULL;

    }      

 

}