首页 > 代码库 > MFC窗口WM_COMMAND消息

MFC窗口WM_COMMAND消息

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

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

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

 

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

 

 

 

 

事实上在多文档框架中,系统自动生成的代码使用的是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消息的响应顺序。
 
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实现不了任何消息的传递。

 

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

 

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

文档类CDocument首先查找自己的响应函数(调用CCmdTarget::OnCmdMsg),然后让其成员m_pDocTemplate来处理。m_pDocTemplate是文档模板类CDocTemplate的指针,MFC框架使用文档模板来实现自动化的文档管理。在应用程序开发过程中,没有针对文档模板类的编程。查看CDocTemplate类中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;
}

存在打开的视图时,视图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类处理消息。所以可以得出如下顺:

 

子框架窗口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),最后让应用程序处理该消息。所以得出顺序:

MFC:

        Win32的封装,窗口体系单元化,单元子父类绘制关系体系和消息响应机制,分别是互绘制机制和

消息传递机制

       

在MFC开发的程序中,菜单、工具条按钮等都会产生WM_COMMAND消息。而在MFC的Document/View框架中,有很多类可以响应WM_COMMAND消息,分别是框架类:CFrameWnd、CMDIChildWndCMDIFrameWnd;应用程序类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的响应函数。所以响应优先级:

 

MFC窗口WM_COMMAND消息