MTK 高亮处理机制


1介绍:
本文旨在介绍MTK平台高亮机制的处理逻辑,相信能对刚入手MTK平台的同学有一定帮助,也能给平时为了项目进度和其他原因,对 MTK的这些基本常识不求甚解,只能依葫芦画瓢的添加菜单和处理函数的同学一个警醒和帮助,能主动去深入了解问题和提高自己。
本人从事MTK的时间也不长,上面的话有些托大,对新手还是说得过去的。文档中有些地方不正确和清楚的,欢迎评论和讨论。
2相关函数和变量列表:
voidRegisterHighlightHandler(void(*f)(S32item_index))
注册窗口的通用高亮处理函数。
MMI_list_highlight_handler
通用高亮处理函数的全局变量指针。
voidExecuteCurrHiliteHandler(S32hiliteid)
当前高亮菜单项的通用处理函数,它会找到菜单项对应的处理函数。一般在窗口创建过程中被创建 RegisterHighlightHandler(ExecuteCurrHiliteHandler)。
FuncPtrmmi_frm_get_hilite_hdlr(U16menu_id)
获取menu_id对应的菜单高亮函数,从两个函数指针数组里获取。先查找动态菜单的高亮函数指针数组,这个是在程序中动态添加的数组;如果找不到,再到静态数组里查找,这个数组是在编译过程中生成的,通常我们在res_mainmenu.c等函数里增加的菜单会被资源生成工具编译成一个静态数组。
mmi_frm_int_hilite_hdlr_table[]动态数组。
mmi_frm_const_hilite_hdlr_table[] 静态数组。
currParentID
当前父窗口全局变量
voidSetHiliteHandler(U16itemid,FuncPtrhiliteFuncPtr)
设置动态高亮数组的MENUID及它相对应的处理函数,一般用在自定义的菜单项。比如在图片浏览、JAVA应用、WAP记录等不可预期菜单项数目的环境,我们不可能做静态的MENUID和处理函数,就需要用到动态的实现方式。
hintData[][]
[待确认]:这是一个动态菜单的数据缓冲,和MENUID一一对应。通俗一点说,就是菜单的显示字符串。网上有文章对此以及 ConstructHintsList()理解应该有误,主要是因为代码里该函数注释说是处理静态的,应该是注释错了。引用一段描述:
3、ConstructHintsList()
ConstructsHintListforastaticmenuscreen
voidConstructHintsList(U16parentID,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(U16menu_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(S32item_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()则在上下按键执行的时候被执行,比响应上按键的函数是 voidfixed_list_goto_previous_item(void),它调用 voidgui_fixed_list_menu_goto_previous_item(fixed_list_menu*m),而 voidgui_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();
来注册按键事件处理函数,其实现过程很简单:
voidregister_fixed_list_keys(void)
{
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();
voidMMI_task(oslEntryType*entry_param)
 InitEvents();还会在InitFramework()中被调用,而InitFramework()会由于开机的状态不同,如USB开机、闹钟开机等,调用流程也不尽相同。具体的可参见我的另一篇应用开机流程的文档。
 4.2菜单结构及查找
4.2.1菜单数数组示意
constCUSTOM_MENUmtk_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_MENUnCustMenus[MAX_MENU_ITEMS];
4.2.2通过父窗口MENUID及高亮INDEX找到高亮窗口 MENUID
U16GetSeqItemId_Ext(U16parent_item_id,U16index)
{
/*----------------------------------------------------------------*/
/*LocalVariables*/
/*----------------------------------------------------------------*/
U8i=0,idx=0;
U16item_id=0;
U8child_count=(U8)nCustMenus[parent_item_id-1].nNumofMenuItem;
 /*----------------------------------------------------------------*/
/*CodeBody*/
/*----------------------------------------------------------------*/
#ifdefDEVAPP_RESOURCE
if(parent_item_id>=MENU_ID_DEVAPP_START)
{
returnDevAppGetSeqItemId_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))/*theitemisnothidden*/
{
if(idx==index)
{
break;
}
else
{
idx++;
}
}
}
MMI_TRACE(MMI_FW_TRC_G2_GUI,MMI_RESGEN_ALL_MENU_HIDE,parent_item_id);
returnitem_id;
}
 4.2.3通过高亮窗口MENUID找到对应的高亮函数
FuncPtrmmi_frm_get_hilite_hdlr(U16menu_id)
{
/*----------------------------------------------------------------*/
/*LocalVariables*/
/*----------------------------------------------------------------*/
U32index;
 /*----------------------------------------------------------------*/
/*CodeBody*/
/*----------------------------------------------------------------*/
 /*Firstlysearchthedynamictable*/
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))
{
returnmmi_frm_int_hilite_hdlr_table[index].hilite_hdlr;
}
/*Andthensearchtheconstanttable.Theconstanttableisgenerantedbyresgen.*/
elseif(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))
{
returnmmi_frm_const_hilite_hdlr_table[index].hilite_hdlr;
}
else
{
returnNULL;
}
}
本文来源于无声无息 http://www.imeans.net/ , 原文地址:http://www.imeans.net/post/201004/44.html

 

发布了81 篇原创文章 · 获赞 6 · 访问量 19万+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章