| 修改人 | 版本号 | 变更说明 | 修改日期 |
| V1.0 | Init | 2009-12-26 | |
|
|
|
|
|
MTK高亮机制
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;
}
}
扫一扫
2754
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
