一、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.
保存前面那個窗體的內容;
2. get the buffer to store the contents of screen to displayed.
獲得足夠的緩存空間來保存當前要顯示的窗體的內容。
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.
獲取要顯示的子菜單條目的個數;
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.
設置按下左右軟件的執行函數;
8. set the function to be called on exiting the next screen.
設置退出下個窗體的的調用函數;
這些工作一般都在窗體的入口函數里面實現的內容,因此我們有必要先從窗體的入口函數開始。以一段代碼來說明(這里省略了很多的東西):
void EntryScrIncomingOptions(void)
{
1、退出上一窗口,進入新的窗口
EntryNewScreen(ITEM_SCR_INCOMING_OPTIONS,NULL, EntryScrIncomingOptions, NULL);
2、獲取當前窗口的GUI buffer
guiBuffer = GetCurrGuiBuffer(ITEM_SCR_INCOMING_OPTIONS);
3、獲取列表窗口的子菜單數目;
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 函數
RegisterHighlightHandler(ExecuteCurrHiliteHandler);
7、在已經獲取了以上信息后,繪制當前的窗口;
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、后面是注冊按鍵函數;
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);
}
這是一個典型的窗口入口函數,窗口的進入都是通過類似的這種 entry××function() 來實現。這時引來另外一個問題,就是關于窗口切換是通過什么來實現的,怎么才能保證這些窗口在切換的過程中保持當時的狀態。這就涉及到history 管理。
History 的管理是通過棧來實現的。在文檔中,我們讀到這樣的內容:
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.
歷史這個概念是用棧來實現的。當一個新的歷史節點加入到這個列表時,它就被加到棧頂,但這個節點被刪除時,它就被從棧頂刪除。
一般來說歷史的應用步驟是這樣的:
1. saving screen contents to history.
保存窗體的數據到歷史中去。這個數據的內容將在下面提到。
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個節點。
還是這樣一個函數:
void EntryFunc()
{
EntryNewScreen( Screen_ID , Exit_Func , Entry_Func , NULL );
guiBuffer = GetCurrGuiBuffer( SCR_ID_WORDMAIN_LIST );
ShowCategroyXXScreen( Title_ID , … , guiBuffer);
}
這里無論是EntryNewScreen的調用,還是guiBuffer的傳入,我們都很少考慮過對這些指針和函數在GUI的管理起到了什么樣的作用。下面我們就要了解,以上的代碼與History管理之間存在的關系。
在MTK環境中,每當我們進入一個窗口,系統將先提取前一個窗口需保留的數據。這些數據包括:
1. 窗口ID ;
2. 進入窗口時調用的函數和退出調用的函數 -- Exit_Func 和 Entry_Func ;
3. 組成窗體的控件的屬性(如,列表控件當前高亮顯示的條目、當前屏的首末條目等)。
通過跟蹤調試程序可以看到 這些動作是在每次調用 EntryNewScreen函數的時候實現的。具體的實現過程就是 :EntryNewScreen函數先將上次執行EntryNewScreen時所記錄的currExitScrnID, currEntryFuncPtr以history結構為載體記錄入棧;然后執行了記錄中的currExitFuncPtr;最后將本窗口的scrnID、exitFuncPtr、entryFuncPtr分別記錄入全局變量currExitScrnID、currExitFuncPtr和currEntryFuncPtr,留待下次調用EntryNewScreen時使用。在退出本窗口的時候通過GoBackHistory 出棧,返回到本窗口的父窗口。
舉例說明這些數據在實際中是如何被使用的。
假設存在AB兩個窗口,A窗口需要保留的數據為data_A。我們先從A窗口進入到B窗口。data_A將在B窗口調用EntryNewScreen()的時候,被壓入一個結構類似于棧的數據存儲區域;當從B調用GoBackHistory()返回A時,data_A從棧頂被彈出,然后A利用data_A將自身還原到其進入B之前的狀態。
這就是History管理的作用。簡言之,就是要保持窗口的外觀狀態。到這里,我們就回答了前面所提出的問題。
本文來自CSDN博客,轉載請標明出處:http://blog.csdn.net/xzl04/archive/2009/04/11/4063062.aspx