AFX-Meldungen
Diese Nachrichten werden in MFC verwendet.
Nachrichten
In der folgenden Tabelle sind Nachrichten aufgeführt, die in der MFC-Bibliothek verwendet werden:
| Nachricht | 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. | Wird 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. | Wird 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. | 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. |
Wird 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 zum Anpassen an das Hauptrahmenfenster 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. | Wird nicht verwendet. | Keinen. |
| AFX_WM_DELETETOOLBAR | Wird an das Hauptrahmenfenster 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. |
Wird nicht verwendet. | Zeiger auf ein CMFCToolBar zu löschende Objekt. |
Nonzero, wenn eine Symbolleiste nicht gelöscht werden kann; andernfalls 0. |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton sendet diese Nachricht an das Hauptrahmenfenster, um die Dokumentfarben abzurufen. |
Wird 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 Hauptrahmenfenster gesendet, wenn ein Benutzer ein Menübandlistenelement hervorhebt. | Index des hervorgehobenen Elements | Ein Zeiger auf CMFCBaseRibbonElement |
Wird nicht verwendet. |
| AFX_WM_ON_AFTER_SHELL_COMMAND | Wird an ein übergeordnetes Element oder CMFCShellListCtrl CMFCShellTreeCtrl Steuerelemente gesendet, wenn ein Benutzer die Ausführung eines Shellbefehls beendet hat. |
Die ID des Befehls, den der Benutzer ausgeführt hat | Wird 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. | Wird nicht verwendet. | Ein Zeiger auf CMFCBaseRibbonElement |
Wird 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 Hauptrahmen, wenn der Benutzer die aktive Menüband-Steuerelementkategorie ändert. | Wird nicht verwendet. | Ein Zeiger auf die CMFCRibbonBar Kategorie, deren Kategorie geändert wurde. |
Wird 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. |
Wird nicht verwendet. | Ein Zeiger auf CMFCDesktopAlertWnd ein Objekt. |
Wird 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 Hauptrahmenfenster gesendet, wenn ein Registerkartenfenster eine QuickInfo für eine Registerkarte anzeigt, wenn benutzerdefinierte QuickInfos aktiviert sind. | Wird nicht verwendet. | Ein Zeiger auf eine CMFCTabToolTipInfo Struktur. |
Wird 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. | Wird 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 Hauptrahmenfenster 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 Beschriftung der Steuerelementleiste klickt. |
Wird 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. | Wird 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 Hauptframe 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. |
Wird nicht verwendet. |
| AFX_WM_RESETCONTEXTMENU | Wird beim Zurücksetzen des Kontextmenüs während der Anpassung an das Hauptframefenster gesendet. | Die Ressourcen-ID des Kontextmenüs. | Ein Zeiger auf das aktuelle Kontextmenü, CMFCPopupMenu. |
Wird nicht verwendet. |
| AFX_WM_RESETKEYBOARD | Das Framework sendet diese Nachricht an das Hauptframefenster, wenn der Benutzer während der Anpassung alle Tastenkombinationen 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. | Wird 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. | Wird nicht verwendet. |
| AFX_WM_TOOLBARMENU | Wird an das Hauptframefenster gesendet, wenn der Benutzer die rechte Maustaste einer Maus loslässt, während sich der Mauszeiger im Client- oder nicht-Clientbereich eines Bereichs befindet. | Wird 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 | CMFCWindowsManagerDialog sendet 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 "Hilfebeschriftung " oder die F1-TASTE klickt. |
Wird nicht verwendet. | Ein Zeiger auf die Instanz von CMFCWindowsManagerDialog. |
Wird 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 |