菜单命令消息路由过程分析

xiaoxiao2021-02-27  141

我们利用VS2008中的MFC AppWizard建立一个名为Menu的单文档工程。打开资源视图中的IDR_MAINFRAME菜单,如图1所示。

            图1 默认的IDR_MAINFRAME菜单

我们可以在虚线框中输入用户自定菜单名,这里名为Test。在属性列表里PopUp类型设置为False,ID号编辑为IDM_TEST。如图2所示。

           图2 添加后的IDR_MAINFRAME菜单

在Test菜单上点击鼠标右键,点击“添加事件处理程序”,消息类型设置为Command,类列表选择CMainFrame,最后点击“添加编辑”,如图3所示。

                                     图3 菜单命令响应函数设置

设置完成后,在MainFrm.h和MainFrm.cpp中会增加如下代码:

[cpp]  view plain  copy //MainFrm.h 响应函数声明   afx_msg void OnTest();      //MainFrm.cpp 命令消息映射宏   BEGIN_MESSAGE_MAP(CMainFrame, CFrameWnd)   ON_COMMAND(ID_TEST, &CMainFrame::OnTest)   END_MESSAGE_MAP()      //MainFrm.cpp 消息响应函数实现   void CMainFrame::OnTest()   {       // TODO: 在此添加命令处理程序代码     }   按照相同的方式,分别在CMenuApp、CMenuDoc、CMenuView、CMenuFrame添加OnTest消息响应函数,并添加的内容分别如下:

[cpp]  view plain  copy CMenuApp:AfxMessageBox("app click");   CMenuDoc:AfxMessageBox("Doc click");   CMenuView:MessageBox("View click");   CMenuFrame:MessageBox("Mainframe click");  

运行程序,发现最先响应该消息的是CMenuView中的OnTest响应函数。删除CMenuView中的OnTest响应函数,重新执行程序,最先响应消息的是CMenuDoc中的OnTest响应函数;

以此类推我们可以得到OnTest菜单命令响应函数顺序是:视类->文档类->框架类->应用程序类

在分析菜单命令路由原理之前,先介绍下Windows消息的分类。

Windows消息分类

实际上,菜单命令也是一种消息,在Windows中,消息被分为以下三类:

第一类:标准消息

除了WM_COMMAND之外,所有的WM_开头的消息都是标准消息。从CWnd派生的类,都可以接收这类消息。

例如WM_CHAR,WM_CLOSE,WM_CREATE等。

第二类:命令消息

来自菜单、加速键或工具栏按钮的消息。这类消息都以WM_COMMAND形式呈现。在MFC中,通过菜单项的ID来区分不同的命令消息,从CCmdTarget派生的类,都可以接收这类消息。

第三类:通告消息

由控件产生的消息,例如按钮的单击、列表框的选择等都会产生这类消息,目的是为了向其父窗口(通常是对话框)通知事件的产生。这类消息也是以WM_COMMAND形式呈现的。从CCmdTarget派生的类,都可以接收这类消息。

在本例中CMenuDoc和CWinApp类从CCmdTarget类派生出来,这两个类对象只能接收命令消息和通过消息。而CMenuView、CMenuFrame类继承于CWnd类,Cwnd类又从CCmdTarget派生出来,因此CMenuView、CMenuFrame的对象对这三种消息都能接收。

菜单命令路由分析

点击Test菜单,通过分析函数调用栈,可以得到菜单命令消息路由过程,如图4所所示。

                                      图4 命令消息的路由

MFC在后台把窗口过程函数替换成AfxWndProc函数,该函数位于wincore.cpp文件中,最终AfxWndProc间接的又调用了OnWndMsg函数,该函数完成对Windows消息的分类处理,这三种消息都是通过消息映射机制完成的。

若是标准消息,则利用形式如“ON_WM_MOUSEMOVE()”消息映射宏完成标准消息的处理。

若是命令消息,则交给OnCommand函数来处理。

若是通告消息,则交给OnNotify函数来处理。

OnCommand函数和OnNotify函数最终都交给OnCmdMsg函数完成最后的处理,即在查找对应的消息响应函数。

从之前实验可以得到,Test菜单响应的顺序是视类->文档类->框架类->应用程序类,现在从源码角度分析下菜单命令响应过程。从图4可以知道菜单命令路由过程需要调用OnCommand和OnCmdMsg两个函数,它们的函数声明如下:

[cpp]  view plain  copy virtual BOOL OnCmdMsg(UINT nID, int nCode, void* pExtra,       AFX_CMDHANDLERINFO* pHandlerInfo);   virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);   可以知道,这两个都是虚函数,OnComand在CWnd类中声明的接口,OnCmdMsg在CCmdTarget 类中声明的接口,Cview、CFrameWnd、CDocument类都会相应的重写这两个接口,从而实现多态。

下面代码展示了菜单命令响应过程:

[cpp]  view plain  copy //首先响应菜单命令消息的是框架类   BOOL CFrameWnd::OnCommand(WPARAM wParam, LPARAM lParam)       // return TRUE if command invocation was attempted   {       HWND hWndCtrl = (HWND)lParam;       UINT nID = LOWORD(wParam);          CFrameWnd* pFrameWnd = GetTopLevelFrame();       ENSURE_VALID(pFrameWnd);       ...          // route as normal command,调用基类的OnCommand函数实现(1)       return CWnd::OnCommand(wParam, lParam);   }      BOOL CWnd::OnCommand(WPARAM wParam, LPARAM lParam)   {       UINT nID = LOWORD(wParam);       HWND hWndCtrl = (HWND)lParam;       int nCode = HIWORD(wParam);          // default routing for command messages (through closure table)       if (hWndCtrl == NULL)       {           // zero IDs for normal commands are not allowed           if (nID == 0)               return FALSE;           // make sure command has not become disabled before routing           CTestCmdUI state;           state.m_nID = nID;           //多态,调用CMainFrame中的OnCmdMsg(2)           OnCmdMsg(nID, CN_UPDATE_COMMAND_UI, &state, NULL);           ...           // menu or accelerator           nCode = CN_COMMAND;       }       else       {          ...       }          return OnCmdMsg(nID, nCode, NULL, NULL);   }      // CFrameWnd command/message routing   BOOL CFrameWnd::OnCmdMsg(UINT nID, int nCode, void* pExtra,       AFX_CMDHANDLERINFO* pHandlerInfo)   {       CPushRoutingFrame push(this);          // pump through current view FIRST ,视图类(3-4),包含视类和文档类       CView* pView = GetActiveView();       if (pView != NULL && pView->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))           return TRUE;          // then pump through frame 主框架(5),CWnd::OnCmdMsg查找的映射表是CMainFrame中       if (CWnd::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))           return TRUE;          // last but not least, pump through  app类(6)       CWinApp* pApp = AfxGetApp();       if (pApp != NULL && pApp->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))           return TRUE;          return FALSE;   }      BOOL CView::OnCmdMsg(UINT nID, int nCode, void* pExtra,       AFX_CMDHANDLERINFO* pHandlerInfo)   {       // first pump through pane 先视类(3)       if (CWnd::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo))           return TRUE;          // then pump through document 后文档类(4)       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;   }  

我们将代码总结为如下:

                                                                                                                          图4 菜单命令路由整个过程

图4 是菜单命令路由的整个过程,到这菜单命令路由分析到此结束了!

转载请注明原文地址: https://www.6miu.com/read-14953.html

最新回复(0)