大家在编程的过程中一定遇到过这种情况：
需要根据某个变量的值来设定菜单项是否被选中，设置工具栏按钮是否被按下或者在状态栏中显示一些信息。
MFC提供了一种机制来帮助我们完成这项工作：
只要用ClassWizard给相应的菜单项或者工具栏按钮添加一个UPDATE_COMMAND_UI处理函数，在其中用CcmdUI::SetCheck等函数来设置这些用户界面元素的状态就可以了。但是MFC是怎么实现这个功能的呢？
首先让我们来看看菜单状态更新的实现方法。首先要知道，当你点现了一个有子菜单的菜单项时(比如菜单栏上的“文件”)，系统会向拥有这个菜单的窗口发送一个WM_INITMENUPOPUP，
下面是MFC对这个消息的默认处理：
- 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 == (UINT) - 1)
- {
- // m_nID==-1表示它下面还有popup menu(就那种带右箭头的菜单项)，它是不会自动deisable的
- // ....
- }
- 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 == (UINT) - 1)
{
// m_nID==-1表示它下面还有popup menu(就那种带右箭头的菜单项)，它是不会自动deisable的
// ....
}
else
{
state.m_pSubMenu = NULL;
state.DoUpdate(this, m_bAutoMenuEnable && state.m_nID < 0xF000);
}
}
}
下面是CCmdUI::DoUpdate的代码：
- BOOL CCmdUI::DoUpdate(CCmdTarget* pTarget, BOOL bDisableIfNoHndler)
- {
- m_bEnableChanged = FALSE;
- BOOL bResult = pTarget->OnCmdMsg(m_nID, CN_UPDATE_COMMAND_UI, this, NULL);
- if (bDisableIfNoHndler && !m_bEnableChanged)
- {
- AFX_CMDHANDLERINFO info;
- info.pTarget = NULL;
- BOOL bHandler = pTarget->OnCmdMsg(m_nID, CN_COMMAND, this, &info);
- Enable(bHandler)
- }
- return bResult;
- }
BOOL CCmdUI::DoUpdate(CCmdTarget* pTarget, BOOL bDisableIfNoHndler)
{
m_bEnableChanged = FALSE;
BOOL bResult = pTarget->OnCmdMsg(m_nID, CN_UPDATE_COMMAND_UI, this, NULL);
if (bDisableIfNoHndler && !m_bEnableChanged)
{
AFX_CMDHANDLERINFO info;
info.pTarget = NULL;
BOOL bHandler = pTarget->OnCmdMsg(m_nID, CN_COMMAND, this, &info);
Enable(bHandler)
}
return bResult;
}
DoUpdate的流程就是：
先向你的菜单项发一个CN_UPDATE_COMMAND_UI命令消息，让你的菜单项来进行显示前的更新,这就是你在classwizard中可以看到的UPDATE_COMMADN_UI消息，你加的处理函数就是在这个时候被调用的。
如果你处理了CN_UPDATE_COMMAND_UI，那么m_bEnableChanged就变成true，接下来就直接返回了。
否则，如果bDisableIfNoHndler也为true，那么就向菜单项发一个CN_COMMAND消息，如果你不响应这个消息，说明这个菜单项还没有处理函数，那么，bnHandler就是flase,然后Enable(false)就把你的菜单项变灰了。
注意, 在CFrameWnd::OnInitMenuPopup中调用DoUpdate时的参数是m_bAutoMenuEnable && state.m_nID < 0xF000，这说如果你一开始就把m_bAutoMenuEnable设为false的话，实际上就关闭了MFC自动diable没有处理函数的菜单项的功能。
工具栏的更新用的是另外一套方法。首先需要知道当你的的程序变得空闲，没有消息需要处理的时候，MFC会调用CWinApp::OnIdle函数利用这个时间进行一些特殊的工作，其中之一就是更新你的工具栏和状态栏。
下面来看相关的代码：
- BOOL CWinThread::OnIdle(LONG lCount)
- {
- if (lCount <= 0)
- {
- //依次向main window及其所有子窗口发送WM_IDLEUPDATECMDUI消息，这个消息指示接收窗口进行更新操作
- CWnd* pMainWnd = m_pMainWnd;
- if (pMainWnd != NULL && pMainWnd->m_hWnd != NULL && pMainWnd->IsWindowVisible())
- {
- AfxCallWndProc(pMainWnd, pMainWnd->m_hWnd, WM_IDLEUPDATECMDUI, (WPARAM)TRUE, 0);
- pMainWnd->SendMessageToDescendants（WM_IDLEUPDATECMDUI,(WPARAM)TRUE, 0, TRUE, TRUE);
- }
- //接下来向本线程创建的所有frame window发送WM_IDLEUPDATECMDUI消息
- AFX_MODULE_THREAD_STATE* pState = _AFX_CMDTARGET_GETSTATE()->m_thread;
- CFrameWnd* pFrameWnd = pState->m_frameList;
- while (pFrameWnd != NULL)
- {
- if (pFrameWnd->IsWindowVisible()||pFrameWnd->m_nShowDelay >= 0)
- {
- AfxCallWndProc(pFrameWnd, pFrameWnd->m_hWnd, WM_IDLEUPDATECMDUI, (WPARAM)TRUE, 0);
- pFrameWnd->SendMessageToDescendants(WM_IDLEUPDATECMDUI, (WPARAM)TRUE, 0, TRUE, TRUE);
- }
- }
- }
- }
BOOL CWinThread::OnIdle(LONG lCount)
{
if (lCount <= 0)
{
//依次向main window及其所有子窗口发送WM_IDLEUPDATECMDUI消息，这个消息指示接收窗口进行更新操作
CWnd* pMainWnd = m_pMainWnd;
if (pMainWnd != NULL && pMainWnd->m_hWnd != NULL && pMainWnd->IsWindowVisible())
{
AfxCallWndProc(pMainWnd, pMainWnd->m_hWnd, WM_IDLEUPDATECMDUI, (WPARAM)TRUE, 0);
pMainWnd->SendMessageToDescendants（WM_IDLEUPDATECMDUI,(WPARAM)TRUE, 0, TRUE, TRUE);
}
//接下来向本线程创建的所有frame window发送WM_IDLEUPDATECMDUI消息
AFX_MODULE_THREAD_STATE* pState = _AFX_CMDTARGET_GETSTATE()->m_thread;
CFrameWnd* pFrameWnd = pState->m_frameList;
while (pFrameWnd != NULL)
{
if (pFrameWnd->IsWindowVisible()||pFrameWnd->m_nShowDelay >= 0)
{
AfxCallWndProc(pFrameWnd, pFrameWnd->m_hWnd, WM_IDLEUPDATECMDUI, (WPARAM)TRUE, 0);
pFrameWnd->SendMessageToDescendants(WM_IDLEUPDATECMDUI, (WPARAM)TRUE, 0, TRUE, TRUE);
}
}
}
}
你的toolbar或者statusbar总是某个frame window的子窗口(包括子窗口的子窗口…)，所以它肯定能收到WM_IDLEUPDATECMDUI消息。
CToolBar和CStatusBar都是从CControlBar派生的，
下面是CControlBar对这个消息的处理：
- LRESULT CControlBar::OnIdleUpdateCmdUI(WPARAM wParam, LPARAM)
- {
- if ((GetStyle() & WS_VISIBLE) )
- {
- //将pTarget指向离this最近的父frame window
- CFrameWnd* pTarget = (CFrameWnd*)GetOwner();
- if (pTarget == NULL || !pTarget->IsFrameWnd())
- pTarget = GetParentFrame();
- //调用虚成员函数OnUpdateCmdUI
- if (pTarget != NULL)
- OnUpdateCmdUI(pTarget, (BOOL)wParam);
- }
- return 0L;
- }
LRESULT CControlBar::OnIdleUpdateCmdUI(WPARAM wParam, LPARAM)
{
if ((GetStyle() & WS_VISIBLE) )
{
//将pTarget指向离this最近的父frame window
CFrameWnd* pTarget = (CFrameWnd*)GetOwner();
if (pTarget == NULL || !pTarget->IsFrameWnd())
pTarget = GetParentFrame();
//调用虚成员函数OnUpdateCmdUI
if (pTarget != NULL)
OnUpdateCmdUI(pTarget, (BOOL)wParam);
}
return 0L;
}
OnUpdateCmdUI是CControlBar类的一个纯虚函数，CToolBar中对这个函数进行了定义：
- void CToolBar::OnUpdateCmdUI(CFrameWnd* pTarget, BOOL bDisableIfNoHndler)
- {
- CToolCmdUI state;
- state.m_pOther = this;
- state.m_nIndexMax = DefWindowProc(TB_BUTTONCOUNT, 0, 0); //工具栏上的按钮数
- for (state.m_nIndex=0; state.m_nIndex < state.m_nIndexMax; state.m_nIndex++)
- {
- //如果你派生了自己的CToolBar类，那么先让执行你定义的处理函数来进行状态更新
- if (CWnd::OnCmdMsg(state.m_nID, CN_UPDATE_COMMAND_UI, &state, NULL))
- continue;
- //如果toolbar没有更新自己，让pTarget(也就是离它最近的父frame window)来更新它。比如对于MFC自动生成的SDI框架来说，pTarget会指向CMainFrame
- state.DoUpdate(pTarget, bDisableIfNoHndler);
- }
- //如果CToolBar中有用户创建的控件，也一起更新
- UpdateDialogControls(pTarget, bDisableIfNoHndler);
- }
void CToolBar::OnUpdateCmdUI(CFrameWnd* pTarget, BOOL bDisableIfNoHndler)
{
CToolCmdUI state;
state.m_pOther = this;
state.m_nIndexMax = DefWindowProc(TB_BUTTONCOUNT, 0, 0); //工具栏上的按钮数
for (state.m_nIndex=0; state.m_nIndex < state.m_nIndexMax; state.m_nIndex++)
{
//如果你派生了自己的CToolBar类，那么先让执行你定义的处理函数来进行状态更新
if (CWnd::OnCmdMsg(state.m_nID, CN_UPDATE_COMMAND_UI, &state, NULL))
continue;
//如果toolbar没有更新自己，让pTarget(也就是离它最近的父frame window)来更新它。比如对于MFC自动生成的SDI框架来说，pTarget会指向CMainFrame
state.DoUpdate(pTarget, bDisableIfNoHndler);
}
//如果CToolBar中有用户创建的控件，也一起更新
UpdateDialogControls(pTarget, bDisableIfNoHndler);
}
CCmdUI::DoUpdate的代码上面已经列出过了。至此，工具栏和状态栏也能顺利也进行更了。
有经验的朋友应该知道，如果你在一个基于对话框的程序里模仿doc/view结构中的方法使用UPDATE_COMMAND_UI来更新用户界面元素的话是不会有任何效果的。
其原因是一个模态对话显示出来以后，程序就会进入这个对话框自己的消息循环(看看DoModal的源码就能了解这一点)，此时不会再有WM_IDLEUPDATECMDUI被发送到这些界面元素中。
下面说说这种情况下的解决办法，你可以自己查看MFC的源码来弄清它的原理：
首先加一个头文件afxpriv.h(其中定义了KICKIDLE消息)，然后添加一个消息映射来处理WM_KICKIDLE消息：ON_MESSAGE(WM_KICKIDLE,OnKickIdle)。
其中OnKickIdle定义如下：
- LRESULT CTabDialog::OnKickIdle(WPARAM wp, LPARAM lCount)
- {
- UpdateDialogControls(this, TRUE);
- return 0;
- }
LRESULT CTabDialog::OnKickIdle(WPARAM wp, LPARAM lCount)
{
UpdateDialogControls(this, TRUE);
return 0;
}
完成这些工作以后,你就可以顺利地使用UPDATE_COMMAND_UI机制了。
---------------------------
CCmdUI
CCmdUI没有基类
它仅在一个CCmdTarget派生类的ON_UPDATE_COMMAND_UI处理程序中使用。
当用户在应用的下拉菜单时，要确定每个菜单项的显示状态——允许存取或禁止存取。
菜单命令的目标通过实现一个ON_UPDATE_COMMAND_UI处理来提供这些信息。可以使用ClassWizard来浏览定位应用中的命令用户接口对象，然后为它建立一个消息映射入口，并为每个消息处理函数提供函数原型。
当菜单被下拉时，框架搜索并调用每个ON_UPDATE_COMMAND_UI处理，每个处理调用Enable和Check之类的成员函数，相应地，框架就可以正确地显示每个菜单项了。
菜单项可以用控件条按钮或者其它的命令用户接口对象替换，而在ON_UPDATE_COMMAND_UI处理中的代码不需要改动。
下表列出了各种命令用户接口上的CCmdGUI的成员函数。
用户接口项 Enable SetCheck SetRadio SetText
菜单项 允许或禁止存取该项 选中(ⅹ)或未选中 选中（有黑点）设置项的文本
工具条按钮 允许或禁止存取该项 选中、未选中或不定 （不可用）与SetCheck相同
状态条状态提示 文本可见或不可见 设置凸出或正常边框 与SetCheck相同 设置状态条的提示文本
CDialogBar中的普通按钮 允许或禁止存取该项 复选框选中或未选中与SetCheck相同 设置按钮的文本
CDialogBar中的普通按钮 允许或禁止存取该项 （不可用） （不可用）设置窗口中的文本
有关使用类CCmdGUI的更详细信息，请参阅联机文档“Visual C++教程”中的“构造用户界面”部分和联机文档“Visual C++程序员指南”中的“如何更新用户界面对象”部分。
3465
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
