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