Сообщения AFX
Эти сообщения используются в MFC.
Сообщения
В следующей таблице перечислены сообщения, используемые в библиотеке MFC.
Сообщение |
Описание |
[входящий] 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, когда пользователь выполнит выполнять команду оболочки. |
Идентификатор команды, пользователь связанный |
Не используется. |
Если процессов приложений это сообщение, то должен возвращают ноль. |
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, когда событие возникает в нашитой полосу прокрутки widget горизонтальной прокрутки. |
Младшее ключевое слово определяет полоса прокрутки отображается значение, которое указывает на запрос прокрутки пользователя. Дополнительные сведения см. в приведенной ниже таблице. |
Не используется. |
Значение не равно нулю. |
AFX_WM_ON_MOVE_TAB |
Отправляется в родительский нашитого окна, когда пользователь перетаскивает вкладки в новое местоположение. |
Индекс с отсчетом от нуля вкладки в его исходном положении. |
[out] индекс с отсчетом от нуля вкладки в его положения. |
Нуль. |
AFX_WM_ON_MOVETABCOMPLETE |
Только для внутреннего пользования. |
Неприменимо. |
Неприменимо. |
Неприменимо. |
AFX_WM_ON_MOVETOTABGROUP |
При фреймовому в главное окно, когда пользователь перемещается дочернее окно MDI из одной группы вкладок в другой. |
Дескриптор нашитому окно (CMFCTabCtrl), из которого было удалено дочернее окно MDI. |
[out] дескриптор a до нашитому окно (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 отправить это сообщение, когда инструмент восстанавливается в исходное состояние, т е загруженному из ресурсов. Процесс это сообщение, чтобы reinsert кнопки панели инструментов классы, производные от 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:
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 |
0x0080 |
AFX_TOOLTIP_TYPE_ALL |
0xFFFF |