MTK HISTROY 小结 2

昨天简单的介绍了下，MTK history 机制，今天还是具体来看代码吧。每个应用都会用得的一个函数  EntryNewScreen 开始，这个函数是进入应用是，一开始回调用的函数，这个函数告诉MTK history 机制，需要进入一个新的应用，原来的应用需要被退出(或者说挂起，保存到历史记录里)，等到新应用退出时，从新回到该应用(或者说恢复状态，这个具体由应用来确定)。

/*
*   newscrnID 新应用的屏幕id(一个应用可能会有多个 屏幕id)
*   newExitHandler 当这个应用退出时被执行的回调函数，无论是那种退出方式(主动，被动)
*   newEntryHandler 如果保存到历史记录里，那么当从历史记录里恢复时，回调用这个函数
*/
U8 EntryNewScreen(U16 newscrnID, FuncPtr newExitHandler, FuncPtr newEntryHandler, void *flag)
{
    
    // 不是 tab page，具体也不是很清楚，这中tab 是什么意思
    // 大部分情况下不用
    if (flag != MMI_TAB_PAGE)
    {
        is_tab_page = MMI_FALSE;
        // 保存当前 屏幕id
        currTopScrnID = newscrnID;

        // mmi_is_orderly_exit_screen 这个参数主要是用于调用 GoBackToHistory 返回到一个指定screen 时使用，这里判断是为了防止重复调用
       
        if (!mmi_is_orderly_exit_screen ||!IsMainLCDHistoryBack())
        {
           
           // 执行 保存历史记录，回调上一应用退出函数                        
            ExecuteCurrExitHandler();
        }
        
        // 
        currExitScrnID = newscrnID;

        if ((newExitHandler != NULL) || (newEntryHandler != NULL))
        {
            // 保存当前活动应用 相关信息
            SetGenericExitHandler(newscrnID, newExitHandler, newEntryHandler);
        }
       

        mmi_is_orderly_exit_screen = MMI_FALSE;
        
        IsBackHistory = MMI_FALSE; 
    }
    else
    {
        is_tab_page = MMI_TRUE;
        ExecuteCurrExitHandler();
        
        curr_tab_exit_func_ptr = newExitHandler;
    
        SetKeyHandler(mmi_frm_general_tab_l_arrow_key_hdlr, KEY_LEFT_ARROW, KEY_EVENT_DOWN);
        SetKeyHandler(mmi_frm_general_tab_r_arrow_key_hdlr, KEY_RIGHT_ARROW, KEY_EVENT_DOWN);
    }
    
    return MMI_TRUE;
}

其实这个函数也没有做什么特别的，主要执行函数 ExecuteCurrExitHandler， 这个函数动作就是执行历史记录保存和回调退出函数。

void ExecuteCurrExitHandler(void)
{
    
    ExecuteCurrExitHandler_Ext();
    // 打开按键声音    
    mmi_frm_kbd_set_tone_state(MMI_KEY_TONE_ENABLED);
    // 清理 按键和触摸屏     
    ClearInputEventHandler(MMI_DEVICE_KEY);
}

这个函数需要注意的是，ClearInputEventHandler。他会把按键和触摸屏所有注册的回调函数都清空，但是需要注意的是，对于按键系统会默认注册END键，这是一个比较特殊的按键，普通情况下，按END键是一键返回到桌面，如果是在打电话状态，那么是挂电话键。举个简单的例子，就是当通电话的时候，如果需要去查看电话本，那么在电话本应用里，END键就是挂电话键，而普通情况下，END键就是一键返回建。

void ExecuteCurrExitHandler_Ext(void)
{
   
    // 处理一些屏幕显示的特出处理，以后分析
    UI_common_screen_pre_exit();

    // 清空 中断 event ，具体分析见 MMI event 小结部分
    if (currEntryFuncPtr || currExitFuncPtr)
    {
        mmi_frm_reset_interrupt_event_context();
    }
    // tab page 退出
    if (curr_tab_exit_func_ptr)
    {
        (*curr_tab_exit_func_ptr)();
        curr_tab_exit_func_ptr = NULL;        
    }

    // 非 tab 推出，这个是最常用的
    if (!is_tab_page)
    {
        //如果有进入函数，也就是说这个应用需要保存到历史记录里
        if (currEntryFuncPtr)
        {  
            //生成历史记录并保存
            GenericExitScreen(currExitScrnID, currEntryFuncPtr);
        }

        // 执行退出函数
        if (currExitFuncPtr)
        {
        
           mmu_frm_execute_scrn_exit_handler = MMI_TRUE;
           (*currExitFuncPtr) ();
           mmu_frm_execute_scrn_exit_handler = MMI_FALSE;
        }


        currEntryFuncPtr = NULL;
        currExitFuncPtr = NULL;
    }  

   
    // 清空高亮信息
    g_mask_hilite_partent_id = 0;
    g_mask_hilite_mask = 0xFFFFFFFF;

    // 结束一些UI 动作
    UI_common_screen_exit();

}

这里需要注意的是 在函数 ExecuteCurrExitHandler_Ext 里面 currEntryFuncPtr 和 currExitFuncPtr 都表示需要被刮起的应用的指针，而不是新应用相应的指针。只有当在调用 SetGenericExitHandler 后，currEntryFuncPtr  和 currExitFuncPtr ，才表示当前应用。

如果不想把当前应用保存到历史记录里面，只要设置 currEntryFuncPtr 为NULL就行。比如A->B->C 而，进入B的时候，设置了 currEntryFuncPtr 为NULL，那么当从C返回时，将直接返回到A，跳过B。