CCmdUi工作原理及作用

ON_UPDATE_COMMAND_UI会一个带有CCmdUI指针参数的函数来响应一个菜单项的单击。第一次见到它时,我差点晕过去! 

让我们来看看它们是怎么工作的。

当用户点击某个菜单时,在菜单弹出之前,会产生一个WM_INITMENUPOPUP消息,并传给菜单所在窗口。以SDI程序为例,CFrameWnd会用void CFrameWnd::OnInitMenuPopup(CMenu* pMenu, UINT nIndex, BOOL bSysMenu)来响应。看看下面的宏就知道了,这是专门用来响应INITMENUPOPUP的: 

[cpp]  view plain copy
  1. #define ON_WM_INITMENUPOPUP() /  
  2.     { WM_INITMENUPOPUP, 0, 0, 0, AfxSig_vMwb, /  
  3.         (AFX_PMSG)(AFX_PMSGW) /  
  4.         (static_castvoid (AFX_MSG_CALL CWnd::*)(CMenu*, UINTBOOL) > ( &ThisClass :: OnInitMenuPopup)) }  

 

MSDN对WM_INITMENUPOPUP的解释: 

[cpp]  view plain copy
  1. WM_INITMENUPOPUP hmenuPopup = (HMENU) wParam;   
  2.   uPos = (UINT)LOWORD(lParam);   
  3.   fSystemMenu = (BOOL)HIWORD(lParam);  
   

wParam为单击菜单句柄,但     OnInitMenuPopup 需要的是CMenu*指针,所以要用FromHandle对其进行格式化了(在OnWndMsg中): 

[cpp]  view plain copy
  1. case AfxSig_v_M_ub:             
  2. (this->*mmf.pfn_v_M_u_b)(CMenu::FromHandle(reinterpret_cast<HMENU>(wParam)),GET_X_LPARAM(lParam), GET_Y_LPARAM(lParam));  
  

看看OnInitMenuPopup是怎么处理WM_INITMENUPOPUP的。 

[cpp]  view plain copy
  1. void CFrameWnd::OnInitMenuPopup(CMenu* pMenu, UINT nIndex, BOOL bSysMenu)  
  2. {  
  3.       …  
  4.        CCmdUI state;  
  5.       state.m_pMenu = pMenu;  
  6.       …  
  7.        state.m_nIndexMax = pMenu->GetMenuItemCount();  
  8.        for (state.m_nIndex = 0; state.m_nIndex < state.m_nIndexMax;//遍历所在子项  
  9.          state.m_nIndex++)  
  10.        {  
  11.               state.m_nID = pMenu->GetMenuItemID(state.m_nIndex);  
  12.               if (state.m_nID == 0)  
  13.                      continue// menu separator or invalid cmd - ignore it  
  14.               if (state.m_nID == (UINT)-1)//判断是什么为弹出项  
  15.               {   
  16.                      ate.m_pSubMenu = pMenu->GetSubMenu(state.m_nIndex);  
  17.                      if (state.m_pSubMenu == NULL ||  
  18.                             (state.m_nID = state.m_pSubMenu->GetMenuItemID(0)) == 0 ||  
  19.                             state.m_nID == (UINT)-1) // 只改了ID,没有改CMenu*  
  20.                      {  
  21.                             continue;       // first item of popup can't be routed to  
  22.                      }  
  23.                      state.DoUpdate(this, FALSE);  
  24.               }  
  25.               else  
  26.               {  
  27.                      state.m_pSubMenu = NULL;  
  28.                      state.DoUpdate(this, m_bAutoMenuEnable && state.m_nID < 0xF000);  
  29.               }  
  30.               …  
  31.        }  
  32. }  
  

可以看见OnInitMenuPopup用pMenu及ID号封装了一个CCmdUI对象state,再state调用DoUpdate。DoUpdate原型: 

BOOL CCmdUI::DoUpdate(CCmdTarget* pTarget, BOOL bDisableIfNoHndler) 

在此函数中调用了 pTarget->OnCmdMsg(m_nID, CN_UPDATE_COMMAND_UI, this, NULL);让消息开始流动。this即CCmdUI指针,作为CFrameWnd::OnCmdMsg(UINT nID, int nCode, void* pExtra,AFX_CMDHANDLERINFO* pHandlerInfo)的第三个参数pExtra往外扔。

最终CCmdUI指针会落到:

_AfxDispatchCmdMsg(CCmdTarget* pTarget, UINT nID, int nCode,

       AFX_PMSG pfn, void* pExtra, UINT_PTR nSig, AFX_CMDHANDLERINFO* pHandlerInfo)中的pExtra里。AfxDispatchCmdMsg里面再将其还原成CCmdUI指针,扔给响应函数。 

[cpp]  view plain copy
  1. CCmdUI* pCmdUI = (CCmdUI*)pExtra;  
  2. ASSERT(!pCmdUI->m_bContinueRouting);    // idle - not set  
  3. (pTarget->*mmf.pfnCmdUI_v_C)(pCmdUI);  
  

这样扔来扔去有什么好处呢?

首先这个过程调用了CFrameWnd::OnCmdMsg,于是这个本只有窗口才能处理的WM_INITMENUPOPUP会被当成WM_COMMAND在对象之间肆意流动。这样比如像文档类这样的非窗口类派生类就有机会处理它了。要知道菜单的状态大多都是取决于文档类中的数据的。

你可能会说单击菜单时不是会产生WM_COMMADN消息吗?对的。但是,对于popup菜单项是没有ID的,也就没有可能利用WM_COMMAND 。只能通过WM_INITMENUPOPUP,何况OnInitMenuPopup还帮你遍历了一次popup下面的全部子项呢! 

相关文章
相关标签/搜索