CCmdUI类
2013-10-31 21:25
369 查看
CCmdUI没有基类。
它仅在一个CCmdTarget派生类的ON_UPDATE_COMMAND_UI处理程序中使用。
当用户在应用的下拉菜单时,要确定每个菜单项的显示状态——允许存取或禁止存取。菜单命令的目标通过实现一个ON_UPDATE_COMMAND_UI处理来提供这些信息。可以使用ClassWizard来浏览定位应用中的命令用户接口对象,然后为它建立一个消息映射入口,并为每个消息处理函数提供函数原型。
当菜单被下拉时,框架搜索并调用每个ON_UPDATE_COMMAND_UI处理,每个处理调用Enable和Check之类的成员函数,相应地,框架就可以正确地显示每个菜单项了。
菜单项可以用控件条按钮或者其它的命令用户接口对象替换,而在ON_UPDATE_COMMAND_UI处理中的代码不需要改动。
所需头文件:#include <afxwin.h>
CCmdUI
CCmdUI::ContinueRouting
void ContinueRouting( );
说明:
本函数通知路由机制继续沿处理链传送当前消息。
本函数应该和一个返回FALSE的ON_COMMAND_EX处理函数联合使用。有关更详细的信息,请参阅“技术指南21”。
CCmdUI::Enable
virtual void Enable( BOOL bOn = TRUE );
参数:
bOn:
如果为TRUE,则把该项设置为允许存取;为FALSE,则设置为禁止存取。
说明:本函数用来设置一个命令是否可以存取用户接口项。
CCmdUI::SetCheck
virtual void SetCheck( int nCheck = 1 );
参数:
nCheck:
指定要设置的选中状态。0表示设置为未选中状态,1表示选中,2表示不确定。
说明:
本函数为命令设置用户接口项相应的选中状态。它对菜单项和工具条按钮起作用。不确定状态只适用于工具条按钮。
CCmdUI::SetRadio
virtual void SetRadio( BOOL bOn = TRUE );
参数:
bOn:
如果为TRUE,则把项设置为允许存取;为FALSE,则设置为禁止存取。
说明:
本函数用于为命令设置用户接口项状态。作用类似于SetCheck,但对单选钮组中的成员起作用。不会自动清除组中其它项的选中状态,除非这些项自己维护了组的行为。
CCmdUI::SetText
virtual void SetText( LPCTSTR lpszText );
参数:
说明:本函数为命令设置用户接口项中的文本。
CCmdUI工作原理及作用
ON_UPDATE_COMMAND_UI会一个带有CCmdUI指针参数的函数来响应一个菜单项的单击。第一次见到它时,我差点晕过去!
让我们来看看它们是怎么工作的。
当用户点击某个菜单时,在菜单弹出之前,会产生一个WM_INITMENUPOPUP消息,并传给菜单所在窗口。以SDI程序为例,CFrameWnd会用void CFrameWnd::OnInitMenuPopup(CMenu* pMenu, UINT nIndex, BOOL bSysMenu)来响应。看看下面的宏就知道了,这是专门用来响应INITMENUPOPUP的:
[cpp]
view plaincopyprint?
#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)) }
#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的解释:
[cpp]
view plaincopyprint?
WM_INITMENUPOPUP hmenuPopup = (HMENU) wParam;
uPos = (UINT)LOWORD(lParam);
fSystemMenu = (BOOL)HIWORD(lParam);
WM_INITMENUPOPUP hmenuPopup = (HMENU) wParam; uPos = (UINT)LOWORD(lParam); fSystemMenu = (BOOL)HIWORD(lParam);
wParam为单击菜单句柄,但 OnInitMenuPopup 需要的是CMenu*指针,所以要用FromHandle对其进行格式化了(在OnWndMsg中):
[cpp]
view plaincopyprint?
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));
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的。
[cpp]
view plaincopyprint?
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);
}
…
}
}
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指针,扔给响应函数。
[cpp]
view plaincopyprint?
CCmdUI* pCmdUI = (CCmdUI*)pExtra;
ASSERT(!pCmdUI->m_bContinueRouting); // idle - not set
(pTarget->*mmf.pfnCmdUI_v_C)(pCmdUI);
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下面的全部子项呢!
它仅在一个CCmdTarget派生类的ON_UPDATE_COMMAND_UI处理程序中使用。
当用户在应用的下拉菜单时,要确定每个菜单项的显示状态——允许存取或禁止存取。菜单命令的目标通过实现一个ON_UPDATE_COMMAND_UI处理来提供这些信息。可以使用ClassWizard来浏览定位应用中的命令用户接口对象,然后为它建立一个消息映射入口,并为每个消息处理函数提供函数原型。
当菜单被下拉时,框架搜索并调用每个ON_UPDATE_COMMAND_UI处理,每个处理调用Enable和Check之类的成员函数,相应地,框架就可以正确地显示每个菜单项了。
菜单项可以用控件条按钮或者其它的命令用户接口对象替换,而在ON_UPDATE_COMMAND_UI处理中的代码不需要改动。
2中文说明
下表列出了各种命令用户接口上的CCmdGUI的成员函数
用户接口项目 | Enable | SetCheck | SetRadio | SetText |
菜单项 | 启用或禁用 | 选取 (×) 或不选 | 使用圆点选取 | 设置项目文本 |
工具栏按钮 | 启用或禁用 | (选择, 未选择或不确定) | 与SetCheck相同 | 不可用) |
状态栏窗格 | 使文本可见或不可见 | 设置弹出或是普通边框 | 与SetCheck相同 | 设置窗格文本 |
CDialogBar中的普通按钮 | 启用或禁用 | 选取或不选复选框 | 与SetCheck相同 | 设置按钮文本 |
CDialogBar中的普通控件 | 启用或禁用 | 不可用) | 不可用) | 设置窗口文本 |
CCmdUI
类的成员
数据成员m_nID | 用户接口对象的ID |
m_nIndex | 用户接口对象的下标 |
m_pMenu | 指向CCmdUI对象代表的菜单 |
m_pSubMenu | 指向CCmdUI对象代表的菜单的子菜单 |
m_pOther | 指向发送通知的窗口对象 |
操作
Enable | 允许或禁止本命令存取用户接口对象 |
SetCheck | 为本命令设置用户接口对象的选中状态 |
SetRadio | 与成员函数SetCheck类似,作用于单选钮组 |
SetText | 为本命令设置用户接口对象的文本 |
ContinueRouting | 通知命令路由机制继续沿处理链传送当前消息 |
void ContinueRouting( );
说明:
本函数通知路由机制继续沿处理链传送当前消息。
本函数应该和一个返回FALSE的ON_COMMAND_EX处理函数联合使用。有关更详细的信息,请参阅“技术指南21”。
CCmdUI::Enable
virtual void Enable( BOOL bOn = TRUE );
参数:
bOn:
如果为TRUE,则把该项设置为允许存取;为FALSE,则设置为禁止存取。
说明:本函数用来设置一个命令是否可以存取用户接口项。
CCmdUI::SetCheck
virtual void SetCheck( int nCheck = 1 );
参数:
nCheck:
指定要设置的选中状态。0表示设置为未选中状态,1表示选中,2表示不确定。
说明:
本函数为命令设置用户接口项相应的选中状态。它对菜单项和工具条按钮起作用。不确定状态只适用于工具条按钮。
CCmdUI::SetRadio
virtual void SetRadio( BOOL bOn = TRUE );
参数:
bOn:
如果为TRUE,则把项设置为允许存取;为FALSE,则设置为禁止存取。
说明:
本函数用于为命令设置用户接口项状态。作用类似于SetCheck,但对单选钮组中的成员起作用。不会自动清除组中其它项的选中状态,除非这些项自己维护了组的行为。
CCmdUI::SetText
virtual void SetText( LPCTSTR lpszText );
参数:
lpszText | 指向字符串的指针。 |
CCmdUI工作原理及作用
ON_UPDATE_COMMAND_UI会一个带有CCmdUI指针参数的函数来响应一个菜单项的单击。第一次见到它时,我差点晕过去!
让我们来看看它们是怎么工作的。
当用户点击某个菜单时,在菜单弹出之前,会产生一个WM_INITMENUPOPUP消息,并传给菜单所在窗口。以SDI程序为例,CFrameWnd会用void CFrameWnd::OnInitMenuPopup(CMenu* pMenu, UINT nIndex, BOOL bSysMenu)来响应。看看下面的宏就知道了,这是专门用来响应INITMENUPOPUP的:
[cpp]
view plaincopyprint?
#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)) }
#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的解释:
[cpp]
view plaincopyprint?
WM_INITMENUPOPUP hmenuPopup = (HMENU) wParam;
uPos = (UINT)LOWORD(lParam);
fSystemMenu = (BOOL)HIWORD(lParam);
WM_INITMENUPOPUP hmenuPopup = (HMENU) wParam; uPos = (UINT)LOWORD(lParam); fSystemMenu = (BOOL)HIWORD(lParam);
wParam为单击菜单句柄,但 OnInitMenuPopup 需要的是CMenu*指针,所以要用FromHandle对其进行格式化了(在OnWndMsg中):
[cpp]
view plaincopyprint?
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));
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的。
[cpp]
view plaincopyprint?
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);
}
…
}
}
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指针,扔给响应函数。
[cpp]
view plaincopyprint?
CCmdUI* pCmdUI = (CCmdUI*)pExtra;
ASSERT(!pCmdUI->m_bContinueRouting); // idle - not set
(pTarget->*mmf.pfnCmdUI_v_C)(pCmdUI);
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下面的全部子项呢!
相关文章推荐
- (队列的应用5.3.3)POJ 3125 Printer Queue(优先队列的使用)
- (队列的应用5.3.1)ZOJ 3210 A Stack or A Queue?根据进入结构的序列和离开结构的序列确定是stack还是queue)
- HDU 1005 Number Sequence
- hdu 4746 Mophues
- JSP中的requenst对象
- HDU 1005 Number Sequence
- HDU 1005 Number Sequence
- UE 的使用
- 用grunt-cmd-xxx构建seajs项目,require css的一个坑
- 人脸识别,并生成包含所有人脸的合适UIImage
- LIRe 源代码分析 2:基本接口(DocumentBuilder)
- LIRe 源代码分析 2:基本接口(DocumentBuilder)
- LIRe 源代码分析 2:基本接口(DocumentBuilder)
- Query通过APD加载数据到DSO出错
- 1028. Hanoi Tower Sequence
- ContentValues 的使用
- easyui datagrid 动态列和前端分页,以及加载Datatable
- MySQL: Starting MySQL….. ERROR! The server quit without updating PID file解决办法
- 多线程编程之 block 与 dispatch quene
- web ui小框架 tab页