一、entryfunction
在文檔里面我們看到下面的條款:
以下引自:write applications using pixtel MMI platform.pdf
Before display the new screen over previous screen the following must be executed:
1. save the contents of previous screen.
保存前面那個(gè)窗體的內(nèi)容;
2. get the buffer to store the contents of screen to displayed.
獲得足夠的緩存空間來(lái)保存當(dāng)前要顯示的窗體的內(nèi)容。
3. get display attribute for the following screen, i.e. item to display as lists, circular menu etc.
獲得下一個(gè)要顯示的窗體的屬性;
4. retrieve number of submenu items to be displayed.
獲取要顯示的子菜單條目的個(gè)數(shù);
5. set the parent of new screen to be displayed.
設(shè)置要被顯示的新窗體的父窗體;
6. set the submenu item to be displayed highlighted, on next screen.
設(shè)置下一級(jí)子菜單要被高亮顯示的條目;
7. set the function to be executed on pressing right or left soft key.
設(shè)置按下左右軟件的執(zhí)行函數(shù);
8. set the function to be called on exiting the next screen.
設(shè)置退出下個(gè)窗體的的調(diào)用函數(shù);
這些工作一般都在窗體的入口函數(shù)里面實(shí)現(xiàn)的內(nèi)容,因此我們有必要先從窗體的入口函數(shù)開(kāi)始。以一段代碼來(lái)說(shuō)明(這里省略了很多的東西):
void EntryScrIncomingOptions(void)
{
1、退出上一窗口,進(jìn)入新的窗口
EntryNewScreen(ITEM_SCR_INCOMING_OPTIONS,NULL, EntryScrIncomingOptions, NULL);
2、獲取當(dāng)前窗口的GUI buffer
guiBuffer = GetCurrGuiBuffer(ITEM_SCR_INCOMING_OPTIONS);
3、獲取列表窗口的子菜單數(shù)目;
number_of_items = GetNumOfChild_Ext(MITEM_OPT_PSEUDO);
4、獲取要顯示的字符串序列;
GetSequenceStringIds_Ext(MITEM_OPT_PSEUDO, list_of_items);
5、設(shè)置當(dāng)前窗口的父窗口的ID;
SetParentHandler(MITEM_OPT_PSEUDO);
6、注冊(cè)highlight 函數(shù)
RegisterHighlightHandler(ExecuteCurrHiliteHandler);
7、在已經(jīng)獲取了以上信息后,繪制當(dāng)前的窗口;
ShowCategory1Screen(
STR_SCR1002_CAPTION,
0,
STR_GLOBAL_OK,
IMG_GLOBAL_OK,
STR_GLOBAL_BACK,
IMG_GLOBAL_BACK,
number_of_items,
list_of_items,
0,
guiBuffer);
8、后面是注冊(cè)按鍵函數(shù);
SetRightSoftkeyFunction(GoBackHistory, KEY_EVENT_UP);
SetKeyHandler(KbCBackCallIncomingRejected, KEY_END, KEY_EVENT_DOWN);
SetKeyHandler(KbCBackCallIncomingAccepted, KEY_SEND, KEY_EVENT_DOWN);
SetSideVolumeKeysForCM();
SetKeyHandler(GoBackHistory, KEY_LEFT_ARROW, KEY_EVENT_DOWN);
}
這是一個(gè)典型的窗口入口函數(shù),窗口的進(jìn)入都是通過(guò)類似的這種 entry××function() 來(lái)實(shí)現(xiàn)。這時(shí)引來(lái)另外一個(gè)問(wèn)題,就是關(guān)于窗口切換是通過(guò)什么來(lái)實(shí)現(xiàn)的,怎么才能保證這些窗口在切換的過(guò)程中保持當(dāng)時(shí)的狀態(tài)。這就涉及到history 管理。
History 的管理是通過(guò)棧來(lái)實(shí)現(xiàn)的。在文檔中,我們讀到這樣的內(nèi)容:
History concept is implemented as a stack. Whenever a new history node is added to the list, it is added at the beginning and whenever a node is deleted it is deleted form the beginning.
歷史這個(gè)概念是用棧來(lái)實(shí)現(xiàn)的。當(dāng)一個(gè)新的歷史節(jié)點(diǎn)加入到這個(gè)列表時(shí),它就被加到棧頂,但這個(gè)節(jié)點(diǎn)被刪除時(shí),它就被從棧頂刪除。
一般來(lái)說(shuō)歷史的應(yīng)用步驟是這樣的:
1. saving screen contents to history.
保存窗體的數(shù)據(jù)到歷史中去。這個(gè)數(shù)據(jù)的內(nèi)容將在下面提到。
2. going back N levers in history and redrawing screen at that depth.
返回到N 級(jí)歷史,并重畫當(dāng)時(shí)的窗體。
3. deleting N nodes from top of stack from history.
從歷史的棧頂刪除N個(gè)節(jié)點(diǎn)。
還是這樣一個(gè)函數(shù):
void EntryFunc()
{
EntryNewScreen( Screen_ID , Exit_Func , Entry_Func , NULL );
guiBuffer = GetCurrGuiBuffer( SCR_ID_WORDMAIN_LIST );
ShowCategroyXXScreen( Title_ID , … , guiBuffer);
}
這里無(wú)論是EntryNewScreen的調(diào)用,還是guiBuffer的傳入,我們都很少考慮過(guò)對(duì)這些指針和函數(shù)在GUI的管理起到了什么樣的作用。下面我們就要了解,以上的代碼與History管理之間存在的關(guān)系。
在MTK環(huán)境中,每當(dāng)我們進(jìn)入一個(gè)窗口,系統(tǒng)將先提取前一個(gè)窗口需保留的數(shù)據(jù)。這些數(shù)據(jù)包括:
1. 窗口ID ;
2. 進(jìn)入窗口時(shí)調(diào)用的函數(shù)和退出調(diào)用的函數(shù) -- Exit_Func 和 Entry_Func ;
3. 組成窗體的控件的屬性(如,列表控件當(dāng)前高亮顯示的條目、當(dāng)前屏的首末條目等)。
通過(guò)跟蹤調(diào)試程序可以看到 這些動(dòng)作是在每次調(diào)用 EntryNewScreen函數(shù)的時(shí)候?qū)崿F(xiàn)的。具體的實(shí)現(xiàn)過(guò)程就是 :EntryNewScreen函數(shù)先將上次執(zhí)行EntryNewScreen時(shí)所記錄的currExitScrnID, currEntryFuncPtr以history結(jié)構(gòu)為載體記錄入棧;然后執(zhí)行了記錄中的currExitFuncPtr;最后將本窗口的scrnID、exitFuncPtr、entryFuncPtr分別記錄入全局變量currExitScrnID、currExitFuncPtr和currEntryFuncPtr,留待下次調(diào)用EntryNewScreen時(shí)使用。在退出本窗口的時(shí)候通過(guò)GoBackHistory 出棧,返回到本窗口的父窗口。
舉例說(shuō)明這些數(shù)據(jù)在實(shí)際中是如何被使用的。
假設(shè)存在AB兩個(gè)窗口,A窗口需要保留的數(shù)據(jù)為data_A。我們先從A窗口進(jìn)入到B窗口。data_A將在B窗口調(diào)用EntryNewScreen()的時(shí)候,被壓入一個(gè)結(jié)構(gòu)類似于棧的數(shù)據(jù)存儲(chǔ)區(qū)域;當(dāng)從B調(diào)用GoBackHistory()返回A時(shí),data_A從棧頂被彈出,然后A利用data_A將自身還原到其進(jìn)入B之前的狀態(tài)。
這就是History管理的作用。簡(jiǎn)言之,就是要保持窗口的外觀狀態(tài)。到這里,我們就回答了前面所提出的問(wèn)題。
本文來(lái)自CSDN博客,轉(zhuǎn)載請(qǐng)標(biāo)明出處:http://blog.csdn.net/xzl04/archive/2009/04/11/4063062.aspx