Freigeben über


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

Nicht verwendet.

Nicht verwendet.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_ACCGETSTATE

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

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

Nicht verwendet.

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

TBBS_DISABLED - Element ist deaktiviert

TBBS_CHECKED - Element ist aktiviert

TBBS_BUTTON - das Element ist ein Standardpushbutton

TBBS_PRESSED - Schaltfläche ist aktiviert

TBBS_INDETERMINATE - nicht definierter Zustand

TBBS_SEPARATOR )anstatt auf eine Menüschaltfläche, bildet dieses Element eine Trennung zwischen anderen Menüelemente

AFX_WM_CHANGE_ACTIVE_TAB

Das Framework sendet diese Meldung in der Größe veränderbaren Steuerleistensteuerelement. Verarbeiten Sie diese Meldung, Benachrichtigungen CMFCTabCtrl-Objekten zu empfangen, wenn ein Benutzer eine aktive Registerkarte ändert.

Der Index einer Registerkarte.

Nicht verwendet.

Wert ungleich 0.

AFX_WM_CHANGE_CURRENT_FOLDER

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

Nicht verwendet.

Nicht verwendet.

Nicht verwendet.

AFX_WM_CHANGEVISUALMANAGER

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

Nicht verwendet.

Nicht verwendet.

Nicht verwendet.

AFX_WM_CHANGING_ACTIVE_TAB

Gesendet übergeordnete Element von CMFCTabCtrl-Objekt. Verarbeiten Sie diese Nachricht, wenn Sie Benachrichtigungen von CMFCTabCtrl-Objekte erhalten möchten, wenn ein Benutzer eine Registerkarte.

Der Index der Registerkarte, die aktiviert ist.

Nicht verwendet.

Wert ungleich 0.

AFX_WM_CHECKEMPTYMINIFRAME

Nur für interne Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_CREATETOOLBAR

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

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 das Hauptrahmenfenster vom Anpassungseigenschaftenblatt CMFCToolbarCustomizeDialog, wenn der Benutzer die Schaltfläche Hilfe oder F1 drückt.

Gibt der aktiven Seite des Anpassungseigenschaftenblattes an.

Ein Zeiger auf ein Objekt CMFCToolbarCustomizeDialog.

0

AFX_WM_CUSTOMIZETOOLBAR

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

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

Nicht verwendet.

0

AFX_WM_DELETETOOLBAR

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

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

Nicht verwendet.

Zeiger zu einem zu löschenden CMFCToolBar-Objekt.

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

AFX_WM_GETDOCUMENTCOLORS

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

Nicht verwendet.

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

0

AFX_WM_GETDRAGBOUNDS

Nur für interne Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM

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

Index des ausgewählten Elements

Ein Zeiger auf CMFCBaseRibbonElement

Nicht verwendet.

AFX_WM_ON_AFTER_SHELL_COMMAND

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

Die ID des Befehls, den der Benutzer ausführen

Nicht verwendet.

Wenn die Anwendungsprozesse diese Meldung, er keinen zurückgeben.

AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU

Das Framework sendet diese Meldung übergeordnete Element des Menübands, bevor das Popupmenü angezeigt. Sie können diese Meldung verarbeiten und Popupmenüs jederzeit ändern.

Nicht verwendet.

Ein Zeiger auf CMFCBaseRibbonElement

Nicht verwendet.

AFX_WM_ON_CANCELTABMOVE

Nur für interne Verwendung.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_ON_CHANGE_RIBBON_CATEGORY

Das Framework sendet diese Meldung zum Hauptframes, wenn der Benutzer die aktuelle Menüband-Steuerelement-Kategorie ändert.

Nicht verwendet.

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

Nicht verwendet.

AFX_WM_ON_CLOSEPOPUPWINDOW

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

Nicht verwendet.

Ein Zeiger auf CMFCDesktopAlertWnd-Objekt.

Nicht verwendet.

AFX_WM_ON_DRAGCOMPLETE

Nur für interne Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_ON_GET_TAB_TOOLTIP

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

Nicht verwendet.

Ein Zeiger auf eine Struktur. CMFCTabToolTipInfo

Nicht verwendet.

AFX_WM_ON_HSCROLL

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

Das Wort niederwertige gibt ein Bildlaufleistenwert an, der der Bildlaufanforderung des Benutzers angibt. Weitere Informationen finden Sie in der Tabelle weiter unten in diesem Thema.

Nicht verwendet.

Wert ungleich 0.

AFX_WM_ON_MOVE_TAB

Gesendet übergeordnete Element 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 in der neuen Position.

0

AFX_WM_ON_MOVETABCOMPLETE

Nur für interne Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_ON_MOVETOTABGROUP

Gesendet das Hauptrahmenfenster, wenn ein Benutzer ein untergeordnetes MDI-Fenster von einer mit als Registerkarten Gruppe in eine andere verschoben wird.

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

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

Sie wird ignoriert.

AFX_WM_ON_PRESS_CLOSE_BUTTON

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

Nicht verwendet.

Ein Zeiger auf einen andockbaren Fenster, auf dem der Benutzer auf die Schaltfläche Schließen geklickt hat.

TRUE, wenn kein Bereich nicht geschlossen werden kann; FALSE andernfalls.

AFX_WM_ON_RENAME_TAB

Gesendet übergeordnete Element des Fensters 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 (null) beim Anwendungsprozesse diese Meldung; das Framework unterdrückt den Aufruf von CMFCBaseTabCtrl::SetTabLabel. Wenn Null zurückgegeben wird, wird CMFCBaseTabCtrl::SetTabLabel vom Framework aufgerufen.

AFX_WM_ON_RIBBON_CUSTOMIZE

Gesendet zu übergeordneten Frame, wenn Benutzer Anpassung startet. Verarbeiten Sie diese Nachricht, wenn Sie Ihr eigenes Anpassungsdialogfeld anzeigen möchten.

Nicht verwendet.

Ein Zeiger auf angepasst werden Menüband-Steuerelement.

Wert ungleich 0 (null) beim 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 für interne Verwendung.

Nicht zutreffend.

Nicht zutreffend.

Nicht zutreffend.

AFX_WM_POSTSETPREVIEWFRAME

Gesendet, um des Hauptframes zu benachrichtigen, dass der Benutzer die Seitenansicht geändert

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

Nicht verwendet.

Nicht verwendet.

AFX_WM_PROPERTY_CHANGED

Gesendet zum Besitzer des Eigenschaftenraster-steuerelements (CMFCPropertyGridCtrl) Wenn der Benutzer den Wert der ausgewählten Eigenschaft ändert.

Die Steuerelement-ID der Liste.

Ein Zeiger auf die Eigenschaft CMFCProp(ertyGridProperty) die geändert wurde.

Nicht verwendet.

AFX_WM_RESETCONTEXTMENU

Gesendet das Hauptrahmenfenster, wenn der Benutzer das Kontextmenü für die Anpassung.

Die Ressourcen-ID des Kontextmenüs.

Ein Zeiger auf das aktuelle Kontextmenü, CMFCPopupMenu.

Nicht verwendet.

AFX_WM_RESETKEYBOARD

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

Nicht verwendet.

Nicht verwendet.

Nicht verwendet.

AFX_WM_RESETMENU

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

Die ID Menüressource

Nicht verwendet.

Nicht verwendet.

AFX_WM_RESETPROMPT

Das Framework sendet diese Nachricht, wenn der Benutzer eine Symbolleiste der Symbolleiste anpassen Dialogfeld. Der Standardhandler zeigt ein Meldungsfeld an, das bewirkt, dass der Benutzer die Symbolleiste ausführen möchte.

Nicht verwendet.

Nicht verwendet.

Nicht verwendet.

AFX_WM_RESETTOOLBAR

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

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

Nicht verwendet.

0

AFX_WM_SHOWREGULARMENU

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

Die Befehls-ID einer Schaltfläche, die die Meldung sendet.

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

Nicht verwendet.

AFX_WM_TOOLBARMENU

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

Nicht verwendet.

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

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

AFX_WM_UPDATETOOLTIPS

Gesendet zu allen QuickInfobesitzern, um anzugeben, dass ihre QuickInfokontrollen neu erstellt werden sollen.

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

Nicht verwendet.

Nicht verwendet.

AFX_WM_WINDOW_HELP

CMFCWindowsManagerDialog sendet diese Meldung für die übergeordneten Frame, wenn der Benutzer auf die Schaltfläche Hilfe klickt, oder gibt den Hilfemodus ein, indem die Hilfe Untertiteln oder die F1-TASTE klickt.

Nicht verwendet.

Ein Zeiger auf die Instanz von CMFCWindowsManagerDialog.

Nicht verwendet.

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

Wert

Bedeutung

SB_ENDSCROLL

Der Benutzer beendet den Bildlauf.

SB_LEFT

Die oben links Benutzerbildläufe zu.

SB_RIGHT

Die Benutzerbildläufe zum rechts.

SB_LINELEFT

Der Benutzer führt links von einer Einheit durch.

SB_LINERIGHT

Die Benutzerbildläufe berichtigen durch eine Einheit.

SB_PAGELEFT

Der Benutzer führt links über die Breite des Fensters durch.

SB_PAGERIGHT

Die Benutzerbildläufe berichtigen über die Breite des Fensters.

SB_THUMBPOSITION

Der Benutzer verfügt das Bildlauffeld (Ziehpunkt) gezogen und die Maustaste losgelassen. Das Wort höherwertige gibt die Position des Bildlauffelds am Ende des Ziehvorgangs an.

SB_THUMBTRACK

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

Hinweis

Das Wort höherwertige des lParam-Parameters gibt der aktuellen Position des Bildlauffelds an, wenn das SB_THUMBPOSITION niederwertige Wort oder SB_THUMBTRACK ist; Andernfalls wird das Wort nicht verwendet.

Die folgende Tabelle zeigt die Flagwerte für den Parameter der lParam 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, globale Funktionen und globale Variablen