AFX消息
这些消息在 MFC。
Messages
下表列出了用于 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 |
发送到主框架窗口从自定义属性表 CMFCToolbarCustomizeDialog，当用户按 帮助 按钮或该 F1 键。 |
指定自定义属性表的事件页。 |
为 CMFCToolbarCustomizeDialog 对象的指针。 |
零。 |
AFX_WM_CUSTOMIZETOOLBAR |
CMFCToolbarCustomizeDialog 发送此信息通知父级框架用户创建新工具栏。 |
TRUE，在自开始，FALSE，在自完成。 |
未使用。 |
零。 |
AFX_WM_DELETETOOLBAR |
发送到主框架窗口，当用户将删除一个工具栏在自定义模式。 当用户在自定义模式时，删除一个工具栏请处理此消息采取其他操作。 您还应调用默认值处理程序 (OnToolbarDelete)，删除工具栏。 默认值处理程序返回一个值删除工具栏是否是可能的。 |
未使用。 |
对要删除的 CMFCToolBar 对象的指针。 |
非零，如果工具栏不能删除；否则为 0。 |
AFX_WM_GETDOCUMENTCOLORS |
CMFCColorMenuButton 发送此消息给主框架窗口中检索文档颜色。 |
未使用。 |
[in，out] CList<COLORREF, COLORREF> 对象的指针。 |
零。 |
AFX_WM_GETDRAGBOUNDS |
仅供内部使用。 |
不适用。 |
不适用。 |
不适用。 |
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM |
发送到主框架窗口，当用户显示一功能区时列表项。 |
突出显示项的索引 |
为 CMFCBaseRibbonElement的指针 |
未使用。 |
AFX_WM_ON_AFTER_SHELL_COMMAND |
发送到 CMFCShellListCtrl 或 CMFCShellTreeCtrl 控件的父级，当用户完成执行 shell 命令。 |
用户执行命令的 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 |
发送到一个选项卡式窗口的父级，当用户拖动选项到新位置。 |
选项的从零开始的索引在其原始位置的。 |
[in] 选项的从零开始的索引在新位置。 |
零。 |
AFX_WM_ON_MOVETABCOMPLETE |
仅供内部使用。 |
不适用。 |
不适用。 |
不适用。 |
AFX_WM_ON_MOVETOTABGROUP |
发送到主框架窗口，当用户从一个选项卡式 MDI 子窗口组移动到另一个。 |
一个句柄 (CMFCTabCtrl) MDI 子窗口中移除的选项卡式窗口。 |
[in] 一个句柄 (CMFCTabCtrl) MDI 子窗口插入的选项卡式窗口。 |
已忽略。 |
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。 |
未使用。 |
零。 |
AFX_WM_SHOWREGULARMENU |
当用户单击标准菜单按钮时，CMFCToolbarMenuButton 对象将此信息传递给它的所有者。 每次处理此消息使用 CMFCToolbarMenuButton 显示弹出菜单，当用户单击按钮时。 |
发送按钮的命令 ID。 |
光标的屏幕坐标。 低序运行指定该 x 坐标。 高位运行指定该 y 坐标。 |
未使用。 |
AFX_WM_TOOLBARMENU |
发送到主框架窗口，当用户松开鼠标的按钮右击，当鼠标指针在窗格的客户端或非工作区时。 |
未使用。 |
鼠标指针的屏幕坐标。 低序运行指定该 x 坐标。 高位运行指定该 y 坐标。 |
零，如果应用程序进程此消息；否则，非零。 |
AFX_WM_UPDATETOOLTIPS |
发送到所有工具提示所有者指示应再次创它们的工具提示控件。 |
应处理此消息控件的类型。 为可能值列表后参见本主题后面的表。 |
未使用。 |
未使用。 |
AFX_WM_WINDOW_HELP |
CMFCWindowsManagerDialog 发送此消息给父级框架，当用户单击 帮助 按钮时，或者通过单击 帮助 声明按钮或 F1 键输入帮助模式。 |
未使用。 |
为 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 信息重复发送与此值，直到用户释放鼠标按钮。 高位运行指示滚动框拖动的位置。 |
备注
如果低序单词是 SB_THUMBPOSITION 或 SB_THUMBTRACK，lParam 参数的高位运行指定滚动框中的当前位置；否则，不使用此单词。
下表列出了 AFX_WM_UPDATETOOLTIPS 消息的 lParam 参数的标志值：
Flag |
值 |
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 |
0x0008 |
AFX_TOOLTIP_TYPE_ALL |
0xFFFF |