MFC中用户界面元素更新原理(UPDATE_COMMAND_UI)

大家在编程的过程中一定遇到过这种情况：

需要根据某个变量的值来设定菜单项是否被选中，设置工具栏按钮是否被按下或者在状态栏中显示一些信息。

MFC提供了一种机制来帮助我们完成这项工作：

只要用ClassWizard给相应的菜单项或者工具栏按钮添加一个UPDATE_COMMAND_UI处理函数，在其中用CcmdUI::SetCheck等函数来设置这些用户界面元素的状态就可以了。但是MFC是怎么实现这个功能的呢？

首先让我们来看看菜单状态更新的实现方法。首先要知道，当你点现了一个有子菜单的菜单项时(比如菜单栏上的“文件”)，系统会向拥有这个菜单的窗口发送一个WM_INITMENUPOPUP，

下面是MFC对这个消息的默认处理：

[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 == (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的代码：

[cpp]
view plaincopyprint?

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函数利用这个时间进行一些特殊的工作，其中之一就是更新你的工具栏和状态栏。

下面来看相关的代码：

[cpp]
view plaincopyprint?

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对这个消息的处理：

[cpp]
view plaincopyprint?

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中对这个函数进行了定义：

[cpp]
view plaincopyprint?

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定义如下：

[cpp]
view plaincopyprint?

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++程序员指南”中的“如何更新用户界面对象”部分。