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

大家在编程的过程中一定遇到过这种情况：需要根据某个变量的值来设定菜单项是否被选中，设置工具栏按钮是否被按下或者在状态栏中显示一些信息。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);             } } 下面是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; } 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);                             }               }        } } 你的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; } 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); } 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; } 完成这些工作以后,你就可以顺利地使用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++程序员指南”中的“如何更新用户界面对象”部分。