AFX 消息
这些消息用于 MFC。
消息
下表列出了 MFC 库中使用的消息：
| 消息 | 说明 | [in] wParam | lParam（所有参数都是 [in]，除非另有说明。） | 返回值 |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | 未使用。 | 未使用。 | 不适用。 | 不适用。 |
| AFX_WM_ACCGETSTATE | 用于辅助功能支持。 将此消息发送到 CMFCPopupMenu 或 CMFCRibbonPanelMenu，以检索当前元素的状态。 |
元素的索引，可以是菜单按钮或分隔符。 | 未使用。 | 元素状态。 如果索引无效，则为 -1；如果菜单按钮没有特殊属性，则为 0。 否则，它是以下标志的组合： TBBS_DISABLED - 项已禁用 TBBS_CHECKED - 项已选中 TBBS_BUTTON - 项是标准推送按钮 TBBS_PRESSED - 按钮已按下 TBBS_INDETERMINATE - 未定义的状态 TBBS_SEPARATOR - 此元素不是菜单按钮，而用于分隔其他菜单项 |
| AFX_WM_CHANGE_ACTIVE_TAB | 框架将此消息发送到可调整大小的控件条控件。 处理此消息以在用户更改活动选项卡时接收来自 CMFCTabCtrl 对象的通知。 |
选项卡的索引。 | 未使用。 | 非零。 |
| AFX_WM_CHANGE_CURRENT_FOLDER | 当用户更改当前文件夹时，框架会将此消息发送到 CMFCShellListCtrl 的父级。 |
未使用。 | 未使用。 | 未使用。 |
| AFX_WM_CHANGEVISUALMANAGER | 当用户更改当前的视觉管理器时，框架会将此消息发送到所有框架窗口。 为了响应此消息，框架窗口会重新计算其区域并根据需要调整其他参数。 如果需要收到有关此事件的通知，可以在应用程序中处理 AFX_WM_CHANGEVISUALMANAGER 消息。 必须调用基类处理程序 (OnChangeVisualManager)，以确保框架对此事件进行内部处理。 |
未使用。 | 未使用。 | 未使用。 |
| AFX_WM_CHANGING_ACTIVE_TAB | 发送到 CMFCTabCtrl 对象的父级。 如果要在用户重置选项卡时接收来自 CMFCTabCtrl 对象的通知，请处理此消息。 |
正在激活的选项卡的索引。 | 未使用。 | 非零。 |
| AFX_WM_CHECKEMPTYMINIFRAME | 仅供内部使用。 | 不适用。 | 不适用。 | 不适用。 |
| AFX_WM_CREATETOOLBAR | 当用户在自定义过程中创建新工具栏时从 CMFCToolBarsListPropertyPage 发送。 可以处理此消息以实例化自定义 CMFCToolBar 派生对象。 如果你处理此消息并创建自己的工具栏，请省略对默认处理程序的调用。 |
未使用。 | 一个指针，指向包含工具栏名称的字符串。 | 指向新创建的工具栏的指针。 NULL 表示工具栏创建已取消。 |
| AFX_WM_CUSTOMIZEHELP | 当用户按下“帮助”按钮或 F1 键时，从自定义属性表 CMFCToolbarCustomize Dialog 发送到主框架窗口。 |
指定自定义属性表的活动页面。 | 一个指向 CMFCToolbarCustomize Dialog 对象的指针。 |
Zero。 |
| AFX_WM_CUSTOMIZETOOLBAR | CMFCToolbarCustomize Dialog 发送此消息以通知父框架用户正在创建新工具栏。 |
自定义开始时为 TRUE，自定义结束时为 FALSE。 | 未使用。 | Zero。 |
| AFX_WM_DELETETOOLBAR | 当用户即将在自定义模式下删除工具栏时发送到主框架窗口。 处理此消息以在用户在自定义模式下删除工具栏时执行其他操作。 还应调用默认处理程序 ( OnToolbarDelete)，这会删除工具栏。 默认处理程序返回一个值，指示是否可以删除工具栏。 |
未使用。 | 指向要删除的 CMFCToolBar 对象的指针。 |
如果无法删除工具栏，则为非零；否则为 0。 |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton 将此消息发送到主框架窗口以检索文档颜色。 |
未使用。 | [in、out] 指向 CList<COLORREF, COLORREF> 对象的指针。 |
Zero。 |
| AFX_WM_GETDRAGBOUNDS | 仅供内部使用。 | 不适用。 | 不适用。 | 不适用。 |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | 当用户突出显示功能区列表项时发送到主框架窗口。 | 突出显示项的索引 | 指向 CMFCBaseRibbonElement 的指针 |
未使用。 |
| AFX_WM_ON_AFTER_SHELL_COMMAND | 当用户执行完 shell 命令时发送到 CMFCShellListCtrl 或 CMFCShellTreeCtrl 控件的父级。 |
用户执行的命令的 ID | 未使用。 | 如果应用程序处理此消息，它应返回零。 |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | 框架在功能区的父级显示弹出菜单之前，向其发送此消息。 你可以随时处理此消息并修改弹出菜单。 | 未使用。 | 指向 CMFCBaseRibbonElement 的指针 |
未使用。 |
| AFX_WM_ON_CANCELTABMOVE | 仅供内部使用。 | 不适用。 | 不适用。 | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | 当用户更改活动功能区控件类别时，框架会将此消息发送到主框架。 | 未使用。 | 指向类别已更改的 CMFCRibbonBar 的指针。 |
未使用。 |
| AFX_WM_ON_CLOSEPOPUPWINDOW | 框架发送此消息以通知 CMFCDesktopAlertWnd 的所有者窗口即将关闭。 |
未使用。 | 指向 CMFCDesktopAlertWnd 对象的指针。 |
未使用。 |
| AFX_WM_ON_DRAGCOMPLETE | 仅供内部使用。 | 不适用。 | 不适用。 | 不适用。 |
| AFX_WM_ON_GET_TAB_TOOLTIP | 如果启用了自定义工具提示，则在选项卡窗口即将显示选项卡的工具提示时发送到主框架窗口。 | 未使用。 | 指向 CMFCTabToolTipInfo 结构的指针。 |
未使用。 |
| AFX_WM_ON_HSCROLL | 发送到可调整大小的控件条控件。 处理此消息，以在选项卡式小组件水平滚动条中发生滚动事件时接收来自 CMFCTabCtrl 对象的通知。 |
低序位字指定一个滚动条值，该值指示用户的滚动请求。 有关更多信息，请参见本主题中后面的表。 | 未使用。 | 非零。 |
| AFX_WM_ON_MOVE_TAB | 当用户将选项卡拖到新位置时，发送到选项卡式窗口的父级。 | 选项卡在其原始位置的从零开始的索引。 | [out] 选项卡在其新位置的从零开始的索引。 | Zero。 |
| AFX_WM_ON_MOVETABCOMPLETE | 仅供内部使用。 | 不适用。 | 不适用。 | 不适用。 |
| AFX_WM_ON_MOVETOTABGROUP | 当用户在选项卡式组之间移动 MDI 子窗口时发送到主框架窗口。 | 已移除 MDI 子窗口的选项卡式窗口 (CMFCTabCtrl) 的句柄。 |
[out] 已插入 MDI 子窗口的选项卡式窗口 (CMFCTabCtrl) 的句柄。 |
已忽略。 |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | 当用户单击控件条标题上的“关闭”按钮时，发送到 CDockablePane 的父级。 |
未使用。 | 指向可停靠窗格的指针，用户单击了该窗格上的“关闭”按钮。 | 如果窗格无法关闭，则为 TRUE；否则为 FALSE。 |
| AFX_WM_ON_RENAME_TAB | 在用户重命名可编辑选项卡后，发送到选项卡式窗口的父级。 | 重命名选项卡的从零开始的索引。 | [out] 指向字符串的指针，该字符串包含新的选项卡名称。 | 如果应用程序处理此消息，则为非零；框架将禁止对 CMFCBaseTabCtrl::SetTabLabel 的调用。 如果返回零，框架将调用 CMFCBaseTabCtrl::SetTabLabel。 |
| AFX_WM_ON_RIBBON_CUSTOMIZE | 当用户开始自定义时发送到父框架。 如果你想显示自己的自定义对话框，请处理此消息。 | 未使用。 | 指向要自定义的功能区控件的指针。 | 如果应用程序处理此消息并显示自己的自定义对话框，则返回非零。 如果应用程序返回零，框架将显示内置的自定义对话框。 |
| AFX_WM_ON_TABGROUPMOUSEMOVE | 仅供内部使用。 | 不适用。 | 不适用。 | 不适用。 |
| AFX_WM_POSTSETPREVIEWFRAME | 发送以通知主框架用户更改了打印预览模式 | TRUE 指示已设置打印预览模式。 FALSE 指示打印预览模式已关闭。 | 未使用。 | 未使用。 |
| AFX_WM_PROPERTY_CHANGED | 当用户更改所选属性的值时，发送给属性网格控件 (CMFCPropertyGridCtrl) 的所有者。 |
属性列表的控件 ID。 | 指向已更改的属性 (CMFCPropertyGridProperty) 的指针。 |
未使用。 |
| AFX_WM_RESETCONTEXTMENU | 当用户在自定义期间重置上下文菜单时，发送到主框架窗口。 | 上下文菜单的资源 ID。 | 指向当前上下文菜单 CMFCPopupMenu 的指针。 |
未使用。 |
| AFX_WM_RESETKEYBOARD | 当用户在自定义期间重置所有键盘快捷键时，框架会将此消息发送到主框架窗口。 | 未使用。 | 未使用。 | 未使用。 |
| AFX_WM_RESETMENU | 当用户在自定义期间重置应用程序框架菜单时，框架会将此消息发送给菜单所有者（框架窗口） | 菜单资源 ID。 | 未使用。 | 未使用。 |
| AFX_WM_RESETPROMPT | 当用户从工具栏自定义对话框重置工具栏时，框架会发送此消息。 默认处理程序显示一个消息框，询问用户是否要重置工具栏。 | 未使用。 | 未使用。 | 未使用。 |
| AFX_WM_RESETTOOLBAR | 当工具栏恢复到其原始状态（即从资源加载）时，CMFCToolBar 对象会发送此消息。 处理此消息以重新插入其类派生自 CMFCToolbarButton 的工具栏按钮。 有关详细信息，请参阅 CMFCToolbarComboBoxButton。 |
已恢复状态的工具栏的资源 ID。 | 未使用。 | Zero。 |
| AFX_WM_SHOWREGULARMENU | 当用户单击常规菜单按钮时，CMFCToolbarMenuButton 对象会将此消息发送给其所有者。 每次在用户单击按钮时使用 CMFCToolbarMenuButton 显示弹出菜单时，处理此消息。 |
发送消息的按钮的命令 ID。 | 光标的屏幕坐标。 低序位字指定 x 坐标。 高序位字指定 y 坐标。 | 未使用。 |
| AFX_WM_TOOLBARMENU | 当鼠标指针位于窗格的工作区或非工作区，且用户松开鼠标右键时，发送到主框架窗口。 | 未使用。 | 鼠标指针的屏幕坐标。 低序位字指定 x 坐标。 高序位字指定 y 坐标。 | 如果应用程序处理此消息，则为零；否则为非零。 |
| AFX_WM_UPDATETOOLTIPS | 发送给所有工具提示所有者，以指示应重新创建其工具提示控件。 | 应处理此消息的控件的类型。 有关可能值的列表，请参阅本主题后面的表。 | 未使用。 | 未使用。 |
| AFX_WM_WINDOW_HELP | 当用户单击“帮助”按钮，或通过单击“帮助”标题按钮或 F1 键进入帮助模式时，CMFCWindowsManagerDialog 会将此消息发送到父框架。 |
未使用。 | 指向 CMFCWindowsManagerDialog 实例的指针。 |
未使用。 |
下表显示了 AFX_WM_HSCROLL 方法的 lParam 参数的低序位字的值：
| 值 | 含义 |
|---|---|
| SB_ENDSCROLL | 用户结束滚动。 |
| SB_LEFT | 用户滚动到左上角。 |
| SB_RIGHT | 用户滚动到右上角。 |
| SB_LINELEFT | 用户向左滚动一个单位。 |
| SB_LINERIGHT | 用户向右滚动一个单位。 |
| SB_PAGELEFT | 用户向左滚动窗口的宽度。 |
| SB_PAGERIGHT | 用户向右滚动窗口的宽度。 |
| SB_THUMBPOSITION | 用户已拖动滚动框（拇指）并松开鼠标按钮。 高序位字指示拖动操作结束时滚动框所在的位置。 |
| SB_THUMBTRACK | 用户正在拖动滚动框。 使用此值重复发送 AFX_WM_ON_HSCROLL 消息，直到用户松开鼠标按钮。 高序位字指示滚动框被拖动到的位置。 |
注意
lParam 参数的高序位字在低序位字为 SB_THUMBPOSITION 或 SB_THUMBTRACK 时，指定滚动框的当前位置；否则，不使用该字。
下表列出了 AFX_WM_UPDATETOOLTIPS 消息的 lParam 参数的标志值：
| 标志 | 值 |
|---|---|
| AFX_TOOLTIP_TYPE_DEFAULT | 0x0001 |
| AFX_TOOLTIP_TYPE_TOOLBAR | 0x0002 |
| AFX_TOOLTIP_TYPE_TAB | 0x0004 |
| AFX_TOOLTIP_TYPE_MINIFRAME | 0x0008 |
| AFX_TOOLTIP_TYPE_DOCKBAR | 0x0010 |
| AFX_TOOLTIP_TYPE_EDIT | 0x0020 |
| AFX_TOOLTIP_TYPE_BUTTON | 0x0040 |
| AFX_TOOLTIP_TYPE_TOOLBOX | 0x0080 |
| AFX_TOOLTIP_TYPE_ALL | 0xFFFF |