`
film
  • 浏览: 224111 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

MFC框架中WM_COMMAND消息响应顺序

阅读更多
 
在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的响应函数。所以响应优先级:
子框架窗口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的消息响应顺序如下:
多文档框架中,有打开的文档时:视图 > 文档 > 子框架窗口 > 应用程序 >主框架窗口
多文档框架在没有打开文档时,应用程序和主框架窗口的顺序相反:主框架窗口 > 应用程序
在单文档框架应用程序中,因为没有子框架窗口,所以顺序应该是:视图 > 文档 >主框架窗口> 应用程序。无论有没有打开文档,主框架窗口都比应用程序类更优先。
作者:苏林
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics