Сообщения AFX
Эти сообщения используются в MFC.
Сообщения
В следующей таблице перечислены сообщения, используемые в библиотеке MFC:
| Message | Description | [in] wParam | lParam (все параметры находятся [в], если иное не указано.) | Возвращаемое значение |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | Не используется. | Не используется. | Неприменимо. | Неприменимо. |
| AFX_WM_ACCGETSTATE | Используется для поддержки специальных возможностей. Отправьте это сообщение CMFCPopupMenu или CMFCRibbonPanelMenu получите состояние текущего элемента. |
Индекс элемента, который может быть кнопкой меню или разделителем. | Не используется. | Состояние элемента. Значение -1, если индекс недопустим, 0, если кнопка меню не имеет специальных атрибутов. В противном случае это сочетание следующих флагов: TBBS_DISABLED — элемент отключен TBBS_CHECKED — проверяется элемент TBBS_BUTTON — элемент является стандартным pushbutton 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 | Отправляется в главное окно фрейма из листа CMFCToolbarCustomize Dialog свойств настройки, когда пользователь нажимает кнопку справки или клавишу F1. |
Указывает активную страницу листа свойств настройки. | Указатель на объект CMFCToolbarCustomize Dialog. |
Ноль. |
| AFX_WM_CUSTOMIZETOOLBAR | Отправляет CMFCToolbarCustomize Dialog это сообщение, чтобы уведомить родительский кадр о том, что пользователь создает новую панель инструментов. |
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 элементы управления, когда пользователь завершает выполнение команды оболочки. |
Идентификатор команды, выполняемой пользователем | Не используется. | Если приложение обрабатывает это сообщение, оно должно возвращать ноль. |
| 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] Отсчитываемый от нуля индекс вкладки в новой позиции. | Ноль. |
| AFX_WM_ON_MOVETABCOMPLETE | Только для внутреннего пользования. | Неприменимо. | Неприменимо. | Неприменимо. |
| AFX_WM_ON_MOVETOTABGROUP | Отправляется в главное окно фрейма при перемещении дочернего окна MDI из одной группы табуляции в другую. | Дескриптор окна с вкладками (CMFCTabCtrl) из которого удалено дочернее окно MDI. |
[out] Дескриптор для окна с вкладками (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) при изменении значения выбранного свойства. |
Идентификатор элемента управления списка свойств. | Указатель на свойство (CMFCPropertyGridProperty), которое изменилось. |
Не используется. |
| AFX_WM_RESETCONTEXTMENU | Отправляется в главное окно фрейма, когда пользователь сбрасывает контекстное меню во время настройки. | Идентификатор ресурса контекстного меню. | Указатель на текущее контекстное меню CMFCPopupMenu. |
Не используется. |
| AFX_WM_RESETKEYBOARD | Платформа отправляет это сообщение в главное окно фрейма, когда пользователь сбрасывает все ускорители клавиатуры во время настройки. | Не используется. | Не используется. | Не используется. |
| AFX_WM_RESETMENU | Платформа отправляет это сообщение владельцу меню (окне фрейма) при сбросе меню фрейма приложения во время настройки | Идентификатор ресурса меню. | Не используется. | Не используется. |
| AFX_WM_RESETPROMPT | Платформа отправляет это сообщение, когда пользователь сбрасывает панель инструментов из диалогового окна настройки панели инструментов. Обработчик по умолчанию отображает окно сообщения, которое спрашивает, хочет ли пользователь сбросить панель инструментов. | Не используется. | Не используется. | Не используется. |
| AFX_WM_RESETTOOLBAR | CMFCToolBar Объект отправляет это сообщение, когда панель инструментов восстанавливается в исходное состояние, то есть загружается из ресурсов. Обработайте это сообщение, чтобы перенастраивать кнопки панели инструментов, классы которых являются производными CMFCToolbarButtonот. Дополнительные сведения см. в разделе CMFCToolbarComboBoxButton. |
Идентификатор ресурса панели инструментов, состояние которой было восстановлено. | Не используется. | Ноль. |
| AFX_WM_SHOWREGULARMENU | CMFCToolbarMenuButton объект отправляет это сообщение владельцу, когда пользователь нажимает обычную кнопку меню. Обработайте это сообщение каждый раз CMFCToolbarMenuButton при отображении всплывающего меню при нажатии кнопки. |
Идентификатор команды кнопки, отправляющей сообщение. | Координаты экрана курсора. Слово с низким порядком указывает координату x. Слово высокого порядка задает координату y. | Не используется. |
| AFX_WM_TOOLBARMENU | Отправляется в главное окно фрейма, когда пользователь освобождает правую кнопку мыши, пока указатель мыши находится в клиентской или не клиентской области области. | Не используется. | Координаты экрана указателя мыши. Слово с низким порядком указывает координату x. Слово высокого порядка задает координату y. | Ноль, если приложение обрабатывает это сообщение; в противном случае — ненулевое значение. |
| AFX_WM_UPDATETOOLTIPS | Отправляется всем владельцам подсказки, чтобы указать, что их элементы управления подсказками должны быть повторно созданы. | Тип элемента управления, который должен обрабатывать это сообщение. См. таблицу далее в этом разделе, чтобы получить список возможных значений. | Не используется. | Не используется. |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialogОтправляет это сообщение в родительский кадр, когда пользователь нажимает кнопку "Справка" или вводит режим справки, нажав кнопку "Подпись справки" или клавишу F1. |
Не используется. | Указатель на экземпляр CMFCWindowsManagerDialog. |
Не используется. |
В следующей таблице показаны значения для низкого слова параметра lParam метода AFX_WM_HSCROLL:
| Значение | Значение |
|---|---|
| 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; в противном случае это слово не используется.
В следующей таблице перечислены значения флага для параметра lParam сообщения AFX_WM_UPDATETOOLTIPS:
| Флаг | Значение |
|---|---|
| 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 |