2中文说明
成员函数
用户接口项目
|
Enable
|
SetCheck
|
SetRadio
|
SetText
|
菜单项
|
启用或禁用
|
选取 (×) 或不选
|
使用圆点选取
|
设置项目文本
|
工具栏按钮
|
启用或禁用
|
(选择, 未选择或不确定)
|
与SetCheck相同
|
不可用)
|
状态栏窗格
|
使文本可见或不可见
|
设置弹出或是普通边框
|
与SetCheck相同
|
设置窗格文本
|
CDialogBar中的普通按钮
|
启用或禁用
|
选取或不选复选框
|
与SetCheck相同
|
设置按钮文本
|
CDialogBar中的普通控件
|
启用或禁用
|
不可用)
|
不可用)
|
设置窗口文本
|
类的成员
m_nID
|
用户接口对象的ID
|
m_nIndex
|
用户接口对象的下标
|
m_pMenu
|
指向CCmdUI对象代表的菜单
|
m_pSubMenu
|
指向CCmdUI对象代表的菜单的子菜单
|
m_pOther
|
指向发送通知的窗口对象
|
操作
Enable
|
允许或禁止本命令存取用户接口对象
|
SetCheck
|
为本命令设置用户接口对象的选中状态
|
SetRadio
|
与成员函数SetCheck类似,作用于单选钮组
|
SetText
|
为本命令设置用户接口对象的文本
|
ContinueRouting
|
通知命令路由机制继续沿处理链传送当前消息
|
lpszText
|
指向字符串的
指针。
|
CCmdUI工作原理及作用
ON_UPDATE_COMMAND_UI会一个带有CCmdUI指针参数的函数来响应一个菜单项的单击。第一次见到它时,我差点晕过去!
让我们来看看它们是怎么工作的。
当用户点击某个菜单时,在菜单弹出之前,会产生一个WM_INITMENUPOPUP消息,并传给菜单所在窗口。以SDI程序为例,CFrameWnd会用void CFrameWnd::OnInitMenuPopup(CMenu* pMenu, UINT nIndex, BOOL bSysMenu)来响应。看看下面的宏就知道了,这是专门用来响应INITMENUPOPUP的:
- #define ON_WM_INITMENUPOPUP() /
- { WM_INITMENUPOPUP, 0, 0, 0, AfxSig_vMwb, /
- (AFX_PMSG)(AFX_PMSGW) /
- (static_cast< void (AFX_MSG_CALL CWnd::*)(CMenu*, UINT, BOOL) > ( &ThisClass :: OnInitMenuPopup)) }
MSDN对WM_INITMENUPOPUP的解释:
- WM_INITMENUPOPUP hmenuPopup = (HMENU) wParam;
- uPos = (UINT)LOWORD(lParam);
- fSystemMenu = (BOOL)HIWORD(lParam);
wParam为单击菜单句柄,但 OnInitMenuPopup 需要的是CMenu*指针,所以要用FromHandle对其进行格式化了(在OnWndMsg中):
- case AfxSig_v_M_ub:
- (this->*mmf.pfn_v_M_u_b)(CMenu::FromHandle(reinterpret_cast<HMENU>(wParam)),GET_X_LPARAM(lParam), GET_Y_LPARAM(lParam));
看看OnInitMenuPopup是怎么处理WM_INITMENUPOPUP的。
- void CFrameWnd::OnInitMenuPopup(CMenu* pMenu, UINT nIndex, BOOL bSysMenu)
- {
- …
- CCmdUI state;
- state.m_pMenu = pMenu;
- …
- state.m_nIndexMax = pMenu->GetMenuItemCount();
- for (state.m_nIndex = 0; state.m_nIndex < state.m_nIndexMax;//遍历所在子项
- state.m_nIndex++)
- {
- state.m_nID = pMenu->GetMenuItemID(state.m_nIndex);
- if (state.m_nID == 0)
- continue; // menu separator or invalid cmd - ignore it
- if (state.m_nID == (UINT)-1)//判断是什么为弹出项
- {
- ate.m_pSubMenu = pMenu->GetSubMenu(state.m_nIndex);
- if (state.m_pSubMenu == NULL ||
- (state.m_nID = state.m_pSubMenu->GetMenuItemID(0)) == 0 ||
- state.m_nID == (UINT)-1) // 只改了ID,没有改CMenu*
- {
- continue; // first item of popup can't be routed to
- }
- state.DoUpdate(this, FALSE);
- }
- else
- {
- state.m_pSubMenu = NULL;
- state.DoUpdate(this, m_bAutoMenuEnable && state.m_nID < 0xF000);
- }
- …
- }
- }
可以看见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指针,扔给响应函数。
- CCmdUI* pCmdUI = (CCmdUI*)pExtra;
- ASSERT(!pCmdUI->m_bContinueRouting); // idle - not set
- (pTarget->*mmf.pfnCmdUI_v_C)(pCmdUI);
这样扔来扔去有什么好处呢?
首先这个过程调用了CFrameWnd::OnCmdMsg,于是这个本只有窗口才能处理的WM_INITMENUPOPUP会被当成WM_COMMAND在对象之间肆意流动。这样比如像文档类这样的非窗口类派生类就有机会处理它了。要知道菜单的状态大多都是取决于文档类中的数据的。
你可能会说单击菜单时不是会产生WM_COMMADN消息吗?对的。但是,对于popup菜单项是没有ID的,也就没有可能利用WM_COMMAND 。只能通过WM_INITMENUPOPUP,何况OnInitMenuPopup还帮你遍历了一次popup下面的全部子项呢!