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

最新推荐文章于 2023-01-02 00:09:42 发布

远方的枫叶

最新推荐文章于 2023-01-02 00:09:42 发布

阅读量732

点赞数

分类专栏： Windows编程文章标签：界面 mfc visual c++ menu

Windows编程专栏收录该内容

13 篇文章

订阅专栏

本文深入解析了MFC如何实现菜单项和工具栏按钮的状态更新，包括菜单状态更新的实现方法和工具栏及状态栏的更新过程。重点介绍了消息处理流程和关键代码段，以及在不同场景下如何正确使用UPDATE_COMMAND_UI机制。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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

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

需要根据某个变量的值来设定菜单项是否被选中，设置工具栏按钮是否被按下或者在状态栏中显示一些信息。
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++程序员指南”中的“如何更新用户界面对象”部分。