AFX-Meldungen

Diese Meldungen werden in MFC verwendet.

Meldungen

Die folgende Tabelle zeigt Meldungen auf, die in der MFC-Bibliothek verwendet werden:

Meldung

Beschreibung

[in] wParam

lParam (alle Parameter sind in [] wenn nicht anders festgelegt.)

Rückgabewert

AFX_WM_ACCGETOBJECT

Wird nicht verwendet.

Wird nicht verwendet.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_ACCGETSTATE

Wird für Barrierefreiheitsunterstützung.Senden Sie diese Meldung zu CMFCPopupMenu oder zu CMFCRibbonPanelMenu, um den Zustand des aktuellen Elements abzurufen.

Index des Elements, der eine Menüschaltfläche oder ein Trennzeichen sein.

Wird nicht verwendet.

Der Zustand des Elements.Es ist -1, wenn der Index ungültig ist, 0, wenn die Menütaste keine Specialattribute verfügt.Andernfalls ist es eine Kombination der folgenden Flags:

TBBS_DISABLED - Element ist deaktiviert

TBBS_CHECKED - Element wird überprüft

TBBS_BUTTON das - Element ist ein Standardpushbutton

TBBS_PRESSED - Schaltfläche wird gedrückt

TBBS_INDETERMINATE - nicht definierter Zustand

TBBS_SEPARATOR - anstatt eine Menüschaltfläche, bildet dieses Element eine Trennung zwischen anderen Menüelementen

AFX_WM_CHANGE_ACTIVE_TAB

Das Framework sendet diese Meldung in das in der Größe veränderbaren Steuerleistensteuerelement.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.

Wert ungleich 0.

AFX_WM_CHANGE_CURRENT_FOLDER

Das Framework sendet diese Meldung zum übergeordneten Element von CMFCShellListCtrl, wenn der Benutzer den aktuellen Ordner geändert hat.

Wird nicht verwendet.

Wird nicht verwendet.

Wird nicht verwendet.

AFX_WM_CHANGEVISUALMANAGER

Das Framework sendet diese Meldung auf alle Rahmenfenstern, wenn der Benutzer den aktuellen visuellen Manager ändert.Als Reaktion auf diese Meldung berechnet ein Rahmenfenster seinen Bereich neu und passt weitere Parameter nach Bedarf.Sie können die AFX_WM_CHANGEVISUALMANAGER-Meldung in der Anwendung verarbeiten, wenn Sie über dieses Ereignis benachrichtigt werden müssen.Sie müssen den Handler (OnChangeVisualManager) aufrufen damit die interne Verarbeitung des Frameworks dieses Ereignisses stattfindet.

Wird nicht verwendet.

Wird nicht verwendet.

Wird nicht verwendet.

AFX_WM_CHANGING_ACTIVE_TAB

Gesendet zum übergeordneten Element von CMFCTabCtrl-Objekt.Verarbeiten Sie diese Meldung, wenn Sie Benachrichtigungen von CMFCTabCtrl-Objekten erhalten möchten, wenn ein Benutzer eine Registerkarte zurücksetzt.

Der Index der Registerkarte, die aktiviert ist.

Wird nicht verwendet.

Wert ungleich 0.

AFX_WM_CHECKEMPTYMINIFRAME

Nur zur internen Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_CREATETOOLBAR

Gesendet von CMFCToolBarsListPropertyPage, wenn ein Benutzer eine neue Symbolleiste während des Anpassungsprozesses erstellt wird.Sie können diese Meldung verarbeiten, um ein CMFCToolBar-abgeleitetes Objekt der benutzerdefinierten zu instanziieren.Wenn Sie diese Meldung bearbeiten und eigene Symbolleiste erstellen, können Sie den Aufruf an den Standardhandler weg.

Wird nicht verwendet.

Ein Zeiger auf eine Zeichenfolge, die den Namen der Symbolleiste enthält.

Ein Zeiger auf die neu erstellten Symbolleiste.NULL gibt an, dass die Symbolleistenerstellung abgebrochen wurde.

AFX_WM_CUSTOMIZEHELP

Gesendet zum Hauptrahmenfenster vom Anpassungseigenschaftenblatt CMFCToolbarCustomizeDialog, wenn der Benutzer die Schaltfläche Hilfe oder F1 drückt.

Gibt die aktuelle Seite des Anpassungseigenschaftenblatts an.

Ein Zeiger auf ein Objekt CMFCToolbarCustomizeDialog.

0

AFX_WM_CUSTOMIZETOOLBAR

CMFCToolbarCustomizeDialog sendet diese Meldung, um die übergeordneten Frames zu benachrichtigen, dass der Benutzer eine neue Symbolleiste erstellt.

TRUE, wenn Anpassung gestartet wird, FALSE, wenn Anpassung beendet wird.

Wird nicht verwendet.

0

AFX_WM_DELETETOOLBAR

Gesendet zum Hauptrahmenfenster, wenn der Benutzer im Begriff ist, eine Symbolleiste im Anpassungsmodus zu löschen.

Verarbeiten Sie diese Nachricht, um zusätzliche Aktionen ausführen, wenn ein Benutzer eine Symbolleiste im Anpassungsmodus gelöscht wird.Sie sollten den Standardhandler (OnToolbarDelete) auch aufrufen, der die Symbolleiste gelöscht wird.Der Standardhandler gibt einen Wert zurück, der angibt, ob es möglich ist, die Symbolleiste zu löschen.

Wird nicht verwendet.

Zeiger auf einen gelöscht werden CMFCToolBar-Objekt.

ungleich 0 (null), wenn eine Symbolleiste nicht gelöscht werden kann; 0 andernfalls.

AFX_WM_GETDOCUMENTCOLORS

CMFCColorMenuButton sendet diese Meldung in das Hauptrahmenfenster, um die Dokumentenfarben abzurufen.

Wird nicht verwendet.

[in, out] Zeiger auf einen CList<COLORREF, COLORREF>-Objekt.

0

AFX_WM_GETDRAGBOUNDS

Nur zur internen Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM

Gesendet zum Hauptrahmenfenster, wenn ein Benutzer ein Menübandlistenelement hervorhebt.

Index des ausgewählten Elements

Ein Zeiger auf CMFCBaseRibbonElement

Wird nicht verwendet.

AFX_WM_ON_AFTER_SHELL_COMMAND

Gesendet mit einem übergeordneten Element von CMFCShellListCtrl oder von CMFCShellTreeCtrl-Steuerelemente, wenn ein Benutzer beendet, einen Shellbefehl auszuführen.

Die ID des Befehls, den der Benutzer ausgeführt hat

Wird nicht verwendet.

Wenn die Anwendungsprozesse diese Nachricht, es null zurückgeben.

AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU

Das Framework sendet diese Nachricht an den übergeordneten des Menübands, bevor das Popupmenü anzeigt.Sie können diese Meldung verarbeiten 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 Meldung im Hauptframes, wenn der Benutzer die aktive Menüband-Steuerelement-Kategorie ändert.

Wird nicht verwendet.

Ein Zeiger auf CMFCRibbonBar, dessen Kategorie geändert hat.

Wird nicht verwendet.

AFX_WM_ON_CLOSEPOPUPWINDOW

Das Framework sendet diese Meldung, um den Besitzer zu CMFCDesktopAlertWnd zu benachrichtigen, den das Fenster ist, geschlossen werden.

Wird nicht verwendet.

Ein Zeiger auf CMFCDesktopAlertWnd-Objekt.

Wird nicht verwendet.

AFX_WM_ON_DRAGCOMPLETE

Nur zur internen Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_ON_GET_TAB_TOOLTIP

Gesendet zum Hauptrahmenfenster, wenn ein Registerkartenfenster im Begriff ist, eine QuickInfo für eine Registerkarte anzuzeigen, wenn benutzerdefinierte QuickInfos aktiviert werden.

Wird nicht verwendet.

Ein Zeiger auf eine Struktur CMFCTabToolTipInfo.

Wird nicht verwendet.

AFX_WM_ON_HSCROLL

Gesendet in der Größe veränderbaren Steuerleistensteuerelement.Verarbeiten Sie diese Nachricht, um Benachrichtigungen von CMFCTabCtrl-Objekten zu empfangen, wenn ein Bildlaufereignis in der des im Registerkartenformat horizontalen Bildlaufleiste Widgets auftritt.

Das niederwertige Wort 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.

Wert ungleich 0.

AFX_WM_ON_MOVE_TAB

Gesendet zum übergeordneten eines Fensters im Registerkartenformat, wenn ein Benutzer eine Registerkarte an eine neue Position zieht.

Der nullbasierte Index der Registerkarte in seiner ursprünglichen Position.

[out] der nullbasierte Index der Registerkarte an seiner neuen Position.

0

AFX_WM_ON_MOVETABCOMPLETE

Nur zur internen Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_ON_MOVETOTABGROUP

Gesendet zum Hauptrahmenfenster, wenn ein Benutzer ein untergeordnetes MDI-Fenster mit den versehenen aus einer Gruppe in eine andere verschoben wird.

Ein Handle zum Fenster im Registerkartenformat (CMFCTabCtrl) aus dem das untergeordnete MDI-Fenster entfernt wurde.

[out] a-Handle zum Fenster im Registerkartenformat (CMFCTabCtrl) auf dem das untergeordnete MDI-Fenster eingefügt wurde.

Sie wird ignoriert.

AFX_WM_ON_PRESS_CLOSE_BUTTON

Gesendet mit einem übergeordneten Element von CDockablePane, wenn Benutzer auf die Schaltfläche Schließen in der Titelleiste der Steuerleiste klickt.

Wird nicht verwendet.

Ein Zeiger auf einen andockbaren Fenster, 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

Gesendet zum übergeordneten Fensters des im Registerkartenformat nach dem Benutzer umbenannt eine bearbeitbare Registerkarte.

Der nullbasierte Index der umbenannten Registerkarte.

[out] Ein Zeiger auf eine Zeichenfolge, die den neuen Registerkartennamen enthält.

Wert ungleich 0 wenn die Anwendungsprozesse diese Meldung; unterdrückt das Framework den Aufruf CMFCBaseTabCtrl::SetTabLabel.Wenn null zurückgegeben wird, wird CMFCBaseTabCtrl::SetTabLabel vom Framework aufgerufen.

AFX_WM_ON_RIBBON_CUSTOMIZE

Gesendet auf Elemente Frame, wenn Benutzer Anpassung startet.Verarbeiten Sie diese Meldung, wenn Sie ein eigenes Anpassungsdialogfeld anzeigen möchten.

Wird nicht verwendet.

Ein Zeiger auf angepasst werden Menüband-Steuerelement.

Wert ungleich 0 wenn die Anwendungsprozesse diese Meldung und Anzeigen sein eigenes Anpassungsdialogfeld.Wenn die Anwendung null zurückgibt, zeigt das Framework integrierte Anpassungsdialogfeld an.

AFX_WM_ON_TABGROUPMOUSEMOVE

Nur zur internen Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_POSTSETPREVIEWFRAME

Gesendet, um den Hauptframes zu benachrichtigen, dass der Benutzer den Seitenansichtsmodus geändert

TRUE gibt an, dass der Seitenansichtsmodus festgelegt ist.FALSE gibt an, dass der Seitenansicht deaktiviert ist.

Wird nicht verwendet.

Wird nicht verwendet.

AFX_WM_PROPERTY_CHANGED

Gesendet zum Besitzer des Eigenschaftraster-steuerelements (CMFCPropertyGridCtrl) 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

Gesendet zum Hauptrahmenfenster, wenn der Benutzer das Kontextmenü während der Anpassung zurücksetzt.

Das Ressourcen-ID des Kontextmenüs.

Ein Zeiger auf das aktuelle Kontextmenü, CMFCPopupMenu.

Wird nicht verwendet.

AFX_WM_RESETKEYBOARD

Das Framework sendet diese Meldung in das Hauptrahmenfenster, wenn der Benutzer alle Zugriffstasten während der Anpassung zurücksetzt.

Wird nicht verwendet.

Wird nicht verwendet.

Wird nicht verwendet.

AFX_WM_RESETMENU

Das Framework sendet diese Meldung in Menübesitzer (ein Rahmenfenster) wenn der Benutzer ein Anwendungsframemenü während der Anpassung zurücksetzt

Die Menüressource ID

Wird nicht verwendet.

Wird nicht verwendet.

AFX_WM_RESETPROMPT

Das Framework sendet diese Meldung, wenn der Benutzer eine Symbolleiste aus der Symbolleiste anpassen Dialogfeld zurücksetzt.Der Standardhandler zeigt ein Meldungsfeld an, das bewirkt, dass der Benutzer die Symbolleiste zurücksetzen möchte.

Wird nicht verwendet.

Wird nicht verwendet.

Wird nicht verwendet.

AFX_WM_RESETTOOLBAR

Ein - Objekt CMFCToolBar sendet diese Meldung, wenn eine Symbolleiste in ihren ursprünglichen Zustand h. wiederhergestellt wird geladen von Ressourcen.Verarbeiten Sie diese Nachricht, um Symbolleisten-Schaltflächen erneut eingefügt, deren Klassen von CMFCToolbarButton abgeleitet werden.Weitere Informationen finden Sie unter CMFCToolbarComboBoxButton.

Das Ressourcen-ID einer Symbolleiste, deren Zustand wiederhergestellt wurde.

Wird nicht verwendet.

0

AFX_WM_SHOWREGULARMENU

CMFCToolbarMenuButton-Objekt sendet diese Nachricht an dem Besitzer, wenn der Benutzer auf eine reguläre Menüschaltfläche klickt.Verarbeiten Sie diese Meldung jedes Mal, wenn Sie CMFCToolbarMenuButton verwenden, um ein Popupmenü anzuzeigen, wenn der Benutzer auf eine Schaltfläche klickt.

Die Befehls-ID einer Schaltfläche, mit der die Nachricht sendet.

Bildschirmkoordinaten des Cursors.Das niederwertige Wort gibt die x-Koordinate an.Das höherwertige Wort gibt die y-Koordinate an.

Wird nicht verwendet.

AFX_WM_TOOLBARMENU

Gesendet zum Hauptrahmenfenster, wenn der Benutzer die rechte Schaltfläche einer Maus freigibt, während der Mauszeiger im Client oder im Nicht-Clientbereich eines Bereichs ist.

Wird nicht verwendet.

Bildschirmkoordinaten des Mauszeigers.Das niederwertige Wort gibt die x-Koordinate an.Das höherwertige Wort gibt die y-Koordinate an.

Null wenn die Anwendungsprozesse diese Meldung; andernfalls Wert ungleich 0.

AFX_WM_UPDATETOOLTIPS

Gesendet auf alle QuickInfobesitzern, um anzugeben, dass ihre QuickInfokontrollen neu erstellt werden sollen.

Der Typ des Steuerelements, der diese Meldung verarbeiten soll.Siehe die Tabelle weiter unten in diesem Thema für eine Liste möglicher Werte.

Wird nicht verwendet.

Wird nicht verwendet.

AFX_WM_WINDOW_HELP

CMFCWindowsManagerDialog sendet diese Nachricht an den übergeordneten Frames, wenn der Benutzer auf die Schaltfläche Hilfe klickt, oder gibt den Hilfemodus ein, indem die Hilfe Beschriftungsschaltfläche oder die F1-TASTE klickt.

Wird nicht verwendet.

Ein Zeiger auf die Instanz von CMFCWindowsManagerDialog.

Wird nicht verwendet.

In der folgenden Tabelle sind die Werte für das niederwertige Wort des lParam-Parameters der AFX_WM_HSCROLL-Methode an:

Wert

Bedeutung

SB_ENDSCROLL

Der Benutzer beendet den Bildlauf.

SB_LEFT

Die Benutzerbildläufe zu dem linken oberen.

SB_RIGHT

Die Benutzerbildläufe an der rechten unteren Ecke.

SB_LINELEFT

Der Benutzer wird links von einer Einheit aus.

SB_LINERIGHT

Die Benutzerbildläufe berichtigen durch eine Einheit.

SB_PAGELEFT

Der Benutzer wird links von der Breite des Fensters aus.

SB_PAGERIGHT

Die Benutzerbildläufe berichtigen durch die Breite des Fensters.

SB_THUMBPOSITION

Der Benutzer hat das Bildlauffeld (Ziehpunkt) gezogen und der Maustaste freigegeben.Das höherwertige Wort gibt die Position des Bildlauffelds am Ende des Ziehvorgangs an.

SB_THUMBTRACK

Der Benutzer ruft das Bildlauffeld.Die AFX_WM_ON_HSCROLL-Meldung wiederholt wird mit diesem Wert übertragen, wenn der Benutzer die Maustaste loslässt.Das höherwertige Wort gibt die Position an, zu der das Bildlauffeld gezogen wurde.

HinweisHinweis

Das höherwertige Wort des Parameters lParam gibt die aktuelle Position des Bildlauffelds an, wenn das niederwertige Wort SB_THUMBPOSITION oder SB_THUMBTRACK ist; andernfalls wird das Wort nicht verwendet.

In der folgenden Tabelle werden die Flagwerte für den lParam-Parameter der AFX_WM_UPDATETOOLTIPS-Meldung auf:

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

Konzepte

MFC-Makros und -globale Werte