MFC框架中WM_COMMAND消息响应顺序

 

在MFC开发的程序中，菜单、工具条按钮等都会产生WM_COMMAND消息。而在MFC的Document/View框架中，有很多类可以响应WM_COMMAND消息，分别是框架类：CFrameWnd、CMDIChildWnd、CMDIFrameWnd；应用程序类CWinApp；文档类CDocument；以及视图类CView。

当应用程序主菜单发送了一个WM_COMMAND消息时，WM_COMMAND消息将会按一定顺序被交这些类的实例，并调用第一个发现的响应函数。以多文档视图框架应用程序为例，我们可以分析MFC中这些类的源代码，并一步一步找出WM_COMMAND消息的响应顺序。

因为框架窗口是菜单的父窗口，所以消息首先发到CMDIFrameWnd类的实例（也就是主框架窗口，通常为CMainFrame）。CMDIFrameWnd类的OnCmdMsg函数如下：

BOOL CMDIFrameWnd::OnCmdMsg(UINT nID, int nCode, void* pExtra,
     AFX_CMDHANDLERINFO* pHandlerInfo)
...{
     CMDIChildWnd* pActiveChild = MDIGetActive();
    // pump through active child FIRST
    if (pActiveChild != NULL)
    ...{
        CPushRoutingFrame push(this);
       if (pActiveChild->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
           return TRUE;
     }

    // then pump through normal frame
    return CFrameWnd::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo);
}

主框架窗口CMDIFrameWnd先查找当前活动的子框架窗口CMDIChildWnd，让其优先访问，然后调用基本框架窗口CFrameWnd的响应函数。所以响应优先级：

子框架窗口CMDIChildWnd > 主框架窗口CMDIFrameWnd

CMDIChildWnd窗口没有重载OnCmdMsg函数，所以使用基本框架窗口CFrameWnd的OnCmdMsg函数：

BOOL CFrameWnd::OnCmdMsg(UINT nID, int nCode, void* pExtra,
     AFX_CMDHANDLERINFO* pHandlerInfo)
...{
     CPushRoutingFrame push(this);

    // pump through current view FIRST
     CView* pView = GetActiveView();
    if (pView != NULL && pView->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
       return TRUE;

    // then pump through frame
    if (CWnd::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
       return TRUE;

    // last but not least, pump through app
     CWinApp* pApp = AfxGetApp();
    if (pApp != NULL && pApp->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
       return TRUE;

    return FALSE;
}

基本框架窗口先让当前活动视图CView响应函数，然后再查找自己的消息响应表（调用CWnd::OnCmdMsg），最后让应用程序处理该消息。所以得出顺序：

存在打开的视图时，视图CView > 子框架CFrame > 应用程序CWinApp >主框架窗口CMDIFrameWnd

没有打开视图时，主框架窗口CMDIFrameWnd > 应用程序CWinApp

再看视图CView类对OnCmdMsg的处理：

BOOL CView::OnCmdMsg(UINT nID, int nCode, void* pExtra,
     AFX_CMDHANDLERINFO* pHandlerInfo)
...{
    // first pump through pane
    if (CWnd::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
       return TRUE;

    // then pump through document
    if (m_pDocument != NULL)
    ...{
       // special state for saving view before routing to document
        CPushRoutingView push(this);
       return m_pDocument->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo);
     }

    return FALSE;
}

视图类首先查找自己的消息响应表（调用CWnd::OnCmdMsg），然后让视图对应的CDocument类处理消息。所以可以得出如下顺：

视图CView > 文档CDocument > 子框架CFrame > 应用程序CWinApp >主框架窗口CMDIFrameWnd

再查看CDocument的OnCmdMsg的实现代码：

BOOL CDocument::OnCmdMsg(UINT nID, int nCode, void* pExtra,
     AFX_CMDHANDLERINFO* pHandlerInfo)
...{
    if (CCmdTarget::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
       return TRUE;

    // otherwise check template
    if (m_pDocTemplate != NULL &&
      m_pDocTemplate->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))
       return TRUE;

    return FALSE;
}

文档类CDocument首先查找自己的响应函数（调用CCmdTarget::OnCmdMsg），然后让其成员m_pDocTemplate来处理。m_pDocTemplate是文档模板类CDocTemplate的指针，MFC框架使用文档模板来实现自动化的文档管理。在应用程序开发过程中，没有针对文档模板类的编程。查看CDocTemplate类中OnCmdMsg的实现：

BOOL CDocTemplate::OnCmdMsg(UINT nID, int nCode, void* pExtra,
     AFX_CMDHANDLERINFO* pHandlerInfo)
...{
     BOOL bReturn;
     CCmdTarget* pFactory = DYNAMIC_DOWNCAST(CCmdTarget, m_pAttachedFactory);

    if (nCode == CN_OLE_UNREGISTER && pFactory != NULL)
        bReturn = pFactory->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo);
    else
        bReturn = CCmdTarget::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo);

    return bReturn;
}

因为应用程序中并没有开发直接从CDocTemplate继承的类，所以应用程序无法使用CDocTemplate的子类定义WM_COMMAND消息的响应函数。CDocTemplate类在OnCmdMsg函数实现里调用的CCmdTarget::OnCmdMsg实现不了任何消息的传递。

事实上在多文档框架中，系统自动生成的代码使用的是CDocTemplate的子类CMultiDocTemplate。在应用程序类（多文档应用框架）的InitInstance()里可以找到类似下面的代码：

    // 注册应用程序的文档模板。文档模板
    // 将用作文档、框架窗口和视图之间的连接
     CMultiDocTemplate* pDocTemplate;
     pDocTemplate = new CMultiDocTemplate(IDR_test3TYPE,
        RUNTIME_CLASS(Ctest3Doc),
        RUNTIME_CLASS(CChildFrame), // 自定义 MDI 子框架
        RUNTIME_CLASS(Ctest3View));
    if (!pDocTemplate)
       return FALSE;

而CMultiDocTemplate类并没有重写OnCmdMsg函数，所以依然不影响WM_COMMAND消息的响应顺序。

通过分析MFC的源代码，我们可以得到WM_COMMAND的消息响应顺序如下：

多文档框架中，有打开的文档时：视图 > 文档 > 子框架窗口 > 应用程序 >主框架窗口

多文档框架在没有打开文档时，应用程序和主框架窗口的顺序相反：主框架窗口 > 应用程序

在单文档框架应用程序中，因为没有子框架窗口，所以顺序应该是：视图 > 文档 >主框架窗口> 应用程序。无论有没有打开文档，主框架窗口都比应用程序类更优先。

作者：苏林