Share via


AFX-Meldungen

Diese Nachrichten werden in MFC verwendet.

Nachrichten

In der folgenden Tabelle sind Nachrichten aufgeführt, die in der MFC-Bibliothek verwendet werden:

`Message` Beschreibung [in] Wparam lParam (Alle Parameter sind [in] sofern nicht anders angegeben.) Rückgabewert
AFX_WM_ACCGETOBJECT Nicht verwendet. Nicht verwendet. Nicht zutreffend. Nicht zutreffend.
AFX_WM_ACCGETSTATE Wird für die Unterstützung der Barrierefreiheit verwendet. Senden Sie diese Nachricht an CMFCPopupMenu oder CMFCRibbonPanelMenu rufen Sie den Status des aktuellen Elements ab. Index des Elements, bei dem es sich um eine Menüschaltfläche oder ein Trennzeichen kann. Nicht verwendet. Der Elementstatus. Dies ist -1, wenn der Index ungültig ist, 0, wenn die Menüschaltfläche keine speziellen Attribute aufweist. Andernfalls handelt es sich um eine Kombination aus den folgenden Flags:

TBBS_DISABLED – Element ist deaktiviert

TBBS_CHECKED – Element wird überprüft

TBBS_BUTTON – das Element ist ein Standard-Pushbutton

TBBS_PRESSED – Schaltfläche wird gedrückt

TBBS_INDETERMINATE – nicht definierter Zustand

TBBS_SEPARATOR – anstelle einer Menüschaltfläche bildet dieses Element eine Trennung zwischen anderen Menüelementen.
AFX_WM_CHANGE_ACTIVE_TAB Das Framework sendet diese Nachricht an das steuerelement für die Größenänderungsleiste. Verarbeiten Sie diese Nachricht, um Benachrichtigungen von CMFCTabCtrl Objekten zu empfangen, wenn ein Benutzer eine aktive Registerkarte ändert. Der Index einer Registerkarte. Nicht verwendet. Nonzero.
AFX_WM_CHANGE_CURRENT_FOLDER Das Framework sendet diese Nachricht an das übergeordnete Element des CMFCShellListCtrl Zeitpunkts, zu dem der Benutzer den aktuellen Ordner geändert hat. Nicht verwendet. Nicht verwendet. Nicht verwendet.
AFX_WM_CHANGEVISUALMANAGER Das Framework sendet diese Nachricht an alle Framefenster, wenn der Benutzer den aktuellen Visual Manager ändert. Als Reaktion auf diese Meldung berechnet ein Framefenster seinen Bereich neu und passt andere Parameter nach Bedarf an. Sie können die AFX_WM_CHANGEVISUALMANAGER Nachricht in Ihrer Anwendung verarbeiten, wenn Sie über dieses Ereignis benachrichtigt werden müssen. Sie müssen den Basisklassenhandler (OnChangeVisualManager) aufrufen, um sicherzustellen, dass die interne Verarbeitung dieses Ereignisses des Frameworks stattfindet. Nicht verwendet. Nicht verwendet. Nicht verwendet.
AFX_WM_CHANGING_ACTIVE_TAB Wird an das übergeordnete Objekt des CMFCTabCtrl Objekts gesendet. Verarbeiten Sie diese Meldung, wenn Sie Benachrichtigungen von CMFCTabCtrl Objekten empfangen möchten, wenn ein Benutzer eine Registerkarte zurücksetzt. Der Index der Registerkarte, die aktiviert wird. Nicht verwendet. Nonzero.
AFX_WM_CHECKEMPTYMINIFRAME Nur zur internen Verwendung Nicht zutreffend. Nicht zutreffend. Nicht zutreffend.
AFX_WM_CREATETOOLBAR Gesendet, CMFCToolBarsListPropertyPage wenn ein Benutzer während des Anpassungsprozesses eine neue Symbolleiste erstellt. Sie können diese Nachricht verarbeiten, um ein benutzerdefiniertes CMFCToolBar-abgeleitetes Objekt zu instanziieren. Wenn Sie diese Nachricht behandeln und eine eigene Symbolleiste erstellen, lassen Sie den Aufruf des Standardhandlers aus. Nicht verwendet. Ein Zeiger auf eine Zeichenfolge, die den Namen der Symbolleiste enthält. Ein Zeiger auf die neu erstellte Symbolleiste. NULL gibt an, dass die Symbolleistenerstellung abgebrochen wurde.
AFX_WM_CUSTOMIZEHELP Wird über das Eigenschaftenblatt CMFCToolbarCustomize Dialog "Anpassung" an das fenster "Standard Rahmen" gesendet, wenn der Benutzer die Schaltfläche "Hilfe" oder die F1-TASTE drückt. Gibt die aktive Seite des Eigenschaftenblatts zum Anpassen an. Ein Zeiger auf ein CMFCToolbarCustomize Dialog-Objekt. Keinen.
AFX_WM_CUSTOMIZETOOLBAR Die CMFCToolbarCustomize Dialog Nachricht sendet diese Nachricht, um den übergeordneten Frame zu benachrichtigen, dass der Benutzer eine neue Symbolleiste erstellt. TRUE, wenn die Anpassung gestartet wird, FALSE, wenn die Anpassung abgeschlossen ist. Nicht verwendet. Keinen.
AFX_WM_DELETETOOLBAR Wird an das Standard Framefenster gesendet, wenn der Benutzer im Anpassungsmodus eine Symbolleiste löschen möchte.

Verarbeiten Sie diese Nachricht, um zusätzliche Aktionen auszuführen, wenn ein Benutzer eine Symbolleiste im Anpassungsmodus löscht. Sie sollten auch den Standardhandler (OnToolbarDelete) aufrufen, der die Symbolleiste löscht. Der Standardhandler gibt einen Wert zurück, der angibt, ob die Symbolleiste gelöscht werden kann.
Nicht verwendet. Zeiger auf ein CMFCToolBar zu löschende Objekt. Nonzero, wenn eine Symbolleiste nicht gelöscht werden kann; andernfalls 0.
AFX_WM_GETDOCUMENTCOLORS CMFCColorMenuButtonsendet diese Nachricht an das Standard Rahmenfenster, um die Dokumentfarben abzurufen. Nicht verwendet. [in, out] Zeiger auf ein CList<COLORREF, COLORREF> Objekt. Keinen.
AFX_WM_GETDRAGBOUNDS Nur zur internen Verwendung Nicht zutreffend. Nicht zutreffend. Nicht zutreffend.
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM Wird an das Standard Rahmenfenster gesendet, wenn ein Benutzer ein Menübandlistenelement hervorhebt. Index des hervorgehobenen Elements Ein Zeiger auf CMFCBaseRibbonElement Nicht verwendet.
AFX_WM_ON_AFTER_SHELL_COMMAND Wird an ein übergeordnetes Element oder CMFCShellListCtrlCMFCShellTreeCtrl Steuerelemente gesendet, wenn ein Benutzer die Ausführung eines Shellbefehls beendet hat. Die ID des Befehls, den der Benutzer ausgeführt hat Nicht verwendet. Wenn die Anwendung diese Meldung verarbeitet, sollte sie Null zurückgeben.
AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU Das Framework sendet diese Nachricht an das übergeordnete Menü des Menübands, bevor das Popupmenü angezeigt wird. Sie können diese Nachricht bearbeiten und Popupmenüs jederzeit ändern. Nicht verwendet. Ein Zeiger auf CMFCBaseRibbonElement Nicht verwendet.
AFX_WM_ON_CANCELTABMOVE Nur zur internen Verwendung Nicht zutreffend. Nicht zutreffend.
AFX_WM_ON_CHANGE_RIBBON_CATEGORY Das Framework sendet diese Nachricht an den Standard Frame, wenn der Benutzer die aktive Menüband-Steuerelementkategorie ändert. Nicht verwendet. Ein Zeiger auf die CMFCRibbonBar Kategorie, deren Kategorie geändert wurde. Nicht verwendet.
AFX_WM_ON_CLOSEPOPUPWINDOW Das Framework sendet diese Nachricht, um den Besitzer CMFCDesktopAlertWnd darüber zu informieren, dass das Fenster geschlossen werden soll. Nicht verwendet. Ein Zeiger auf CMFCDesktopAlertWnd ein Objekt. Nicht verwendet.
AFX_WM_ON_DRAGCOMPLETE Nur zur internen Verwendung Nicht zutreffend. Nicht zutreffend. Nicht zutreffend.
AFX_WM_ON_GET_TAB_TOOLTIP Wird an das Standard Rahmenfenster gesendet, wenn ein Registerkartenfenster eine QuickInfo für eine Registerkarte anzeigt, wenn benutzerdefinierte QuickInfos aktiviert sind. Nicht verwendet. Ein Zeiger auf eine CMFCTabToolTipInfo Struktur. Nicht verwendet.
AFX_WM_ON_HSCROLL Wird an das Steuerelement für die größenveränderbare Steuerelementleiste gesendet. Verarbeiten Sie diese Nachricht, um Benachrichtigungen von CMFCTabCtrl Objekten zu empfangen, wenn ein Bildlaufereignis in der horizontalen Bildlaufleiste des Registerkarten-Widgets auftritt. Das Wort mit niedriger Reihenfolge gibt einen Bildlaufleistenwert an, der die Bildlaufanforderung des Benutzers angibt. Weitere Informationen finden Sie in der Tabelle weiter unten in diesem Thema. Nicht verwendet. Nonzero.
AFX_WM_ON_MOVE_TAB Wird an das übergeordnete Element eines Registerkartenfensters gesendet, wenn ein Benutzer eine Registerkarte an eine neue Position zieht. Der nullbasierte Index der Registerkarte an der ursprünglichen Position. [out] Der nullbasierte Index der Registerkarte an der neuen Position. Keinen.
AFX_WM_ON_MOVETABCOMPLETE Nur zur internen Verwendung Nicht zutreffend. Nicht zutreffend. Nicht zutreffend.
AFX_WM_ON_MOVETOTABGROUP Wird an das Standard Rahmenfenster gesendet, wenn ein Benutzer ein untergeordnetes MDI-Fenster aus einer Registerkartengruppe in eine andere verschiebt. Ein Handle zu Tabstoppfenster (CMFCTabCtrl), aus dem das untergeordnete MDI-Fenster entfernt wurde. [out] Ein Handle für Tabstoppfenster (CMFCTabCtrl), in das das untergeordnete MDI-Fenster eingefügt wurde. Ignoriert.
AFX_WM_ON_PRESS_CLOSE_BUTTON Wird an ein übergeordnetes Element CDockablePane gesendet, wenn der Benutzer auf die Schaltfläche "Schließen" auf der Untertitel der Steuerelementleiste klickt. Nicht verwendet. Ein Zeiger auf einen andockbaren Bereich, auf dem der Benutzer auf die Schaltfläche "Schließen " geklickt hat. TRUE, wenn ein Bereich nicht geschlossen werden kann; andernfalls FALSE.
AFX_WM_ON_RENAME_TAB Wird an das übergeordnete Fenster des Registerkartenfensters gesendet, nachdem der Benutzer eine bearbeitbare Registerkarte umbenannt hat. Der nullbasierte Index der umbenannten Registerkarte. [out] Ein Zeiger auf eine Zeichenfolge, die den neuen Registerkartennamen enthält. Nonzero, wenn die Anwendung diese Nachricht verarbeitet; das Framework unterdrückt den Aufruf von CMFCBaseTabCtrl::SetTabLabel. Wenn Null zurückgegeben wird, CMFCBaseTabCtrl::SetTabLabel wird sie vom Framework aufgerufen.
AFX_WM_ON_RIBBON_CUSTOMIZE Wird beim Starten der Anpassung an den übergeordneten Frame gesendet. Verarbeiten Sie diese Meldung, wenn Sie Ihr eigenes Anpassungsdialogfeld anzeigen möchten. Nicht verwendet. Ein Zeiger auf das Menüband-Steuerelement, das angepasst werden soll. Nonzero, wenn die Anwendung diese Meldung verarbeitet und ein eigenes Anpassungsdialogfeld anzeigt. Wenn die Anwendung null zurückgibt, zeigt das Framework das integrierte Anpassungsdialogfeld an.
AFX_WM_ON_TABGROUPMOUSEMOVE Nur zur internen Verwendung Nicht zutreffend. Nicht zutreffend. Nicht zutreffend.
AFX_WM_POSTSETPREVIEWFRAME Gesendet, um den Standard Frame zu benachrichtigen, dass der Benutzer den Druckvorschaumodus geändert hat TRUE gibt an, dass der Druckvorschaumodus festgelegt ist. FALSE gibt an, dass der Druckvorschaumodus deaktiviert ist. Nicht verwendet. Nicht verwendet.
AFX_WM_PROPERTY_CHANGED Wird an den Besitzer des Eigenschaftenrastersteuerelements (CMFCPropertyGridCtrl) gesendet, wenn der Benutzer den Wert der ausgewählten Eigenschaft ändert. Die Steuerelement-ID der Eigenschaftenliste. Ein Zeiger auf die Eigenschaft (CMFCPropertyGridProperty), die geändert wurde. Nicht verwendet.
AFX_WM_RESETCONTEXTMENU Wird an das Standard Framefenster gesendet, wenn der Benutzer das Kontextmenü während der Anpassung zurücksetzt. Die Ressourcen-ID des Kontextmenüs. Ein Zeiger auf das aktuelle Kontextmenü, CMFCPopupMenu. Nicht verwendet.
AFX_WM_RESETKEYBOARD Das Framework sendet diese Meldung an das Standard Framefenster, wenn der Benutzer während der Anpassung alle Zugriffstasten zurücksetzt. Nicht verwendet. Nicht verwendet. Nicht verwendet.
AFX_WM_RESETMENU Das Framework sendet diese Nachricht an den Menübesitzer (ein Framefenster), wenn der Benutzer während der Anpassung ein Anwendungsframemenü zurücksetzt. Die Menüressourcen-ID. Nicht verwendet. Nicht verwendet.
AFX_WM_RESETPROMPT Das Framework sendet diese Meldung, wenn der Benutzer eine Symbolleiste über das Dialogfeld "Anpassen" der Symbolleiste zurücksetzt. Der Standardhandler zeigt ein Meldungsfeld an, in dem gefragt wird, ob der Benutzer die Symbolleiste zurücksetzen möchte. Nicht verwendet. Nicht verwendet. Nicht verwendet.
AFX_WM_RESETTOOLBAR Ein CMFCToolBar Objekt sendet diese Nachricht, wenn eine Symbolleiste in den ursprünglichen Zustand wiederhergestellt wird, d. h. aus den Ressourcen geladen wird. Verarbeiten Sie diese Meldung, um Symbolleistenschaltflächen erneut einzugeben, deren Klassen von CMFCToolbarButton. Weitere Informationen finden Sie unter CMFCToolbarComboBoxButton. Die Ressourcen-ID einer Symbolleiste, deren Zustand wiederhergestellt wurde. Nicht verwendet. Keinen.
AFX_WM_SHOWREGULARMENU CMFCToolbarMenuButton objekt sendet diese Nachricht an den Besitzer, wenn der Benutzer auf eine normale Menüschaltfläche klickt. Verarbeiten Sie diese Meldung jedes Mal, wenn Sie CMFCToolbarMenuButton ein Popupmenü anzeigen, wenn der Benutzer auf eine Schaltfläche klickt. Die Befehls-ID einer Schaltfläche, die die Nachricht sendet. Bildschirmkoordinaten des Cursors. Das Wort mit niedriger Reihenfolge gibt die X-Koordinate an. Das Wort mit hoher Reihenfolge gibt die y-Koordinate an. Nicht verwendet.
AFX_WM_TOOLBARMENU Wird an das Standard Framefenster gesendet, wenn der Benutzer die rechte Maustaste einer Maus loslässt, während sich der Mauszeiger im Client- oder Nicht-Clientbereich eines Bereichs befindet. Nicht verwendet. Bildschirmkoordinaten des Mauszeigers. Das Wort mit niedriger Reihenfolge gibt die X-Koordinate an. Das Wort mit hoher Reihenfolge gibt die y-Koordinate an. Null, wenn die Anwendung diese Nachricht verarbeitet; andernfalls nonzero.
AFX_WM_UPDATETOOLTIPS Wird an alle QuickInfo-Besitzer gesendet, um anzugeben, dass ihre QuickInfo-Steuerelemente neu erstellt werden sollen. Der Typ des Steuerelements, das diese Nachricht verarbeiten soll. Eine Liste möglicher Werte finden Sie in der Tabelle weiter unten in diesem Thema. Nicht verwendet. Nicht verwendet.
AFX_WM_WINDOW_HELP CMFCWindowsManagerDialogsendet diese Nachricht an den übergeordneten Frame, wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, oder wechselt in den Hilfemodus, indem er auf die Schaltfläche "Hilfe Untertitel" oder die F1-TASTE klickt. Nicht verwendet. Ein Zeiger auf die Instanz von CMFCWindowsManagerDialog. Nicht verwendet.

Die folgende Tabelle zeigt die Werte für das niedrige Wort des lParam-Parameters der AFX_WM_HSCROLL-Methode:

Wert Bedeutung
SB_ENDSCROLL Der Benutzer beendet den Bildlauf.
SB_LEFT Der Benutzer scrollt nach links oben.
SB_RIGHT Der Benutzer scrollt nach unten rechts.
SB_LINELEFT Der Benutzer scrollt um eine Einheit nach links.
SB_LINERIGHT Der Benutzer scrollt um eine Einheit nach rechts.
SB_PAGELEFT Der Benutzer scrollt um die Breite des Fensters nach links.
SB_PAGERIGHT Der Benutzer scrollt um die Breite des Fensters nach rechts.
SB_THUMBPOSITION Der Benutzer hat das Bildlauffeld (Daumen) gezogen und die Maustaste losgelassen. Das Wort mit hoher Reihenfolge gibt die Position des Bildlauffelds am Ende des Ziehvorgangs an.
SB_THUMBTRACK Der Benutzer zieht die Bildlaufbox. Die AFX_WM_ON_HSCROLL Nachricht wird wiederholt mit diesem Wert gesendet, bis der Benutzer die Maustaste loslässt. Das Wort mit hoher Reihenfolge gibt die Position an, an die das Bildlauffeld gezogen wurde.

Hinweis

Das Hochreihenfolgewort des Parameters "lParam " gibt die aktuelle Position des Bildlauffelds an, wenn das Wort in niedriger Reihenfolge SB_THUMBPOSITION oder SB_THUMBTRACK ist. Andernfalls wird dieses Wort nicht verwendet.

In der folgenden Tabelle sind die Flagwerte für den lParam-Parameter der AFX_WM_UPDATETOOLTIPS Nachricht aufgeführt:

Flag Wert
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

Siehe auch

Makros und Globalen