本文共 6251 字，大约阅读时间需要 20 分钟。

00. 目录

01. 概述

引用的此部分列出了所有 消息映射宏 以及所有 CWnd 消息映射项以及相应的成员函数原型：

由于 Windows 是一种面向消息的操作系统，因此 Windows 环境的大部分编程操作都涉及消息处理。 每次发生击键或鼠标单击事件时，都会将一条消息发送到应用程序，然后该应用程序必须处理该事件。

Microsoft 基础类库提供了为基于消息的编程而优化的编程模型。 在此模型中，“消息映射” 用于指定哪些函数将处理特定类的各种消息。 消息映射包含一个或多个宏，这些宏指定哪些消息将由哪些功能处理。 例如，包含宏的消息映射 ON_COMMAND 可能类似于：

BEGIN_MESSAGE_MAP(CMyDoc, CDocument)   ON_COMMAND(ID_MYCMD, &CMyDoc::OnMyCommand)END_MESSAGE_MAP()

ON_COMMAND宏用于处理由菜单、按钮和快捷键生成的命令消息。 可以使用宏来映射以下内容：

Windows 消息

• 控制通知
• 用户定义的消息

命令消息

• 已注册的用户定义消息
• 用户界面更新消息

消息范围

• 命令
• 更新处理程序消息
• 控制通知

02. 消息映射宏

消息映射声明和分界宏

消息映射宏

消息映射范围宏

常用说明

2.1 BEGIN_MESSAGE_MAP

BEGIN_MESSAGE_MAP开始您的消息映射的定义。    语法BEGIN_MESSAGE_MAP( theClass, baseClass )parameterstheClass	指定其消息映射所属的类的名称。baseClass	指定 类 的基类的名称。BEGIN_MESSAGE_MAP(CMainFrame, CMDIFrameWnd)   ON_WM_CREATE()END_MESSAGE_MAP()

备注

在实现 ( .cpp) 文件中，该文件定义了类的成员函数，启动带有 BEGIN_MESSAGE_MAP 宏的消息映射，然后为每个消息处理函数添加宏项，并通过 END_MESSAGE_MAP 宏完成消息映射。

2.2 DECLARE_MESSAGE_MAP

声明类定义消息映射。 CCmdTarget程序中的每个派生类必须提供消息映射来处理消息。

DECLARE_MESSAGE_MAP( )

备注

在类声明的末尾使用 DECLARE_MESSAGE_MAP 宏。 然后，在定义类的成员函数的 .cpp 文件中，使用 BEGIN_MESSAGE_MAP 宏、每个消息处理函数的宏项和 END_MESSAGE_MAP 的宏。

如果在 DECLARE_MESSAGE_MAP 后声明任何成员，则必须为它们指定新的访问类型 (public 、 private 或 protected) 。

示例

class CMainFrame : public CMDIFrameWnd{
      DECLARE_MESSAGE_MAP()   // Remainder of class declaration omitted.}

2.3 END_MESSAGE_MAP

结束消息映射的定义。

END_MESSAGE_MAP( )

2.4 ON_COMMAND

此宏将命令消息映射到成员函数。

ON_COMMAND( commandId, memberFxn )parameterscommandId	命令 ID。memberFxn	命令映射到的消息处理程序函数的名称。

参考示例

BEGIN_MESSAGE_MAP(CMFCListViewDoc, CDocument)   ON_COMMAND(ID_MYCOMMAND, &CMFCListViewDoc::OnMycommand)END_MESSAGE_MAP()

备注

它指示哪个函数将处理命令用户界面对象（如菜单项或工具栏按钮）的命令消息。

当命令目标对象收到具有指定 ID 的 Windows WM_COMMAND 消息时，ON_COMMAND 将调用成员函数 memberFxn 来处理该消息。

使用 ON_COMMAND 将单个命令映射到成员函数。 使用 ON_COMMAND_RANGE 将一系列命令 id 映射到一个成员函数。 只有一个消息映射项可以匹配给定的命令 ID。 也就是说，不能将命令映射到多个处理程序。 有关详细信息和示例，请参阅 消息处理和映射主题。

2.5 ON_OLECMD

通过命令调度接口路由命令 IOleCommandTarget 。

ON_OLECMD( pguid, olecmdid, commandId )parameterspguid	命令所属的命令组的标识符。 对于标准组，请使用 NULL。olecmdid	OLE 命令的标识符。commandId	发出命令的资源或对象的菜单 ID、工具栏 ID、按钮 ID 或其他 ID。

备注

IOleCommandTarget 允许容器接收源自 DocObject 的用户界面的命令，并允许容器在 “文件” 菜单上发送相同的 (命令，如 “新建”、“打开”、“另存” 和 “打印”。以及复制、粘贴、撤消等操作，请在 “编辑” 菜单中) DocObject。

IOleCommandTarget 比 OLE 自动化的更简单 IDispatch 。 IOleCommandTarget 完全依赖于一组标准的命令，这些命令很少包含参数，并且不涉及任何类型信息 (命令参数的类型安全降低) 。 如果确实需要调度带有参数的命令，请使用 。

IOleCommandTarget标准菜单命令已由 MFC 在下列宏中实现：

ON_OLECMD_CLEARSELECTION ( )

调度 “编辑清除” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_CLEARSELECTION, ID_EDIT_CLEAR)

ON_OLECMD_COPY ( )

调度编辑复制命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_COPY, ID_EDIT_COPY)

ON_OLECMD_CUT ( )

调度 “编辑剪切” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_CUT, ID_EDIT_CUT)

ON_OLECMD_NEW ( )

调度 File New 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_NEW, ID_FILE_NEW)

ON_OLECMD_OPEN ( )

调度文件打开命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_OPEN, ID_FILE_OPEN)

ON_OLECMD_PAGESETUP ( )

调度文件页面设置命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_PAGESETUP, ID_FILE_PAGE_SETUP)

ON_OLECMD_PASTE ( )

调度 “编辑粘贴” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_PASTE, ID_EDIT_PASTE)

ON_OLECMD_PASTESPECIAL ( )

调度 “编辑” “选择性粘贴” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_PASTESPECIAL, ID_EDIT_PASTE_SPECIAL)

ON_OLECMD_PRINT ( )

调度文件打印命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_PRINT, ID_FILE_PRINT)

ON_OLECMD_PRINTPREVIEW ( )

调度文件 “打印预览” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_PRINTPREVIEW, ID_FILE_PRINT_PREVIEW)

ON_OLECMD_REDO ( )

调度编辑重做命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_REDO, ID_EDIT_REDO)

ON_OLECMD_SAVE ( )

调度文件保存命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_SAVE, ID_FILE_SAVE)

ON_OLECMD_SAVE_AS ( )

调度文件的 “另存为” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_SAVEAS, ID_FILE_SAVE_AS)

ON_OLECMD_SAVE_COPY_AS ( )

调度 “文件另存为” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_SAVECOPYAS, ID_FILE_SAVE_COPY_AS)

ON_OLECMD_SELECTALL ( )

调度 “编辑全部选择” 命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_SELECTALL, ID_EDIT_SELECT_ALL)

ON_OLECMD_UNDO ( )

调度 “编辑” 撤消命令。 实现方式：

ON_OLECMD(NULL, OLECMDID_UNDO, ID_EDIT_UNDO)

03. 委托和接口映射宏

MFC 为委托和接口映射支持以下宏：

04. 使用消息映射交叉引用

在标记为的项中 ，为派生的 类编写你自己的成员函数。 将函数命名为您喜欢的任何名称。 其他函数，如 OnActivate，是 CWnd 类的成员函数。 如果调用这些函数，则会传递消息给 DefWindowProc Windows 函数。 要处理 Windows 通知消息，请重写派生类中相应的 CWnd 函数。 您的函数应调用基类中的重写函数使基类和 Windows 响应消息。

在所有情况下，请将函数原型放在 CWnd 派生的类标头中，并对消息映射条目进行编码，如下所示。

使用了以下术语：

05. 子窗口通知消息处理程序

有五种类别的子窗口通知消息：

06. WM_ 消息的处理程序

以下主题对应于映射条目。

07. 用户定义的处理程序

以下映射项对应于函数原型。

08. 附录

转载地址：https://dengjin.blog.csdn.net/article/details/113522642 如侵犯您的版权，请留言回复原文章的地址，我们会给您删除此文章，给您带来不便请您谅解！