ON_MESSAGE

Artikel
06/10/2015

Gibt an, die bearbeitet eine benutzerdefinierte Meldung arbeiten.

ON_MESSAGE(message, memberFxn)

Parameter

message
Die Meldungs-ID.
memberFxn
Der Name der Meldungshandlerfunktion, zu der die Nachricht zugeordnet ist.

Der Typ der Funktion muss afx_msg LRESULT (CWnd::*)(WPARAM, LPARAM) sein.

Hinweise

Benutzerdefinierte Meldungen sind alle Nachrichten, die nicht Standard-Meldungen Windows WM_MESSAGE sind. Wenn Sie eine gewünschte Meldungs-ID auswählen, müssen Sie Werte innerhalb des Bereichs von WM_USER (0x0400) zu 0x7FFF oder WM_APP (0x8000) zu 0xBFFF verwenden. Weitere Informationen zu Meldungs-IDs, finden Sie unter WM_APP.

Es sollte eine ON_MESSAGE-Makroanweisung in der Meldungszuordnung für jede benutzerdefinierte Meldung genau geben, die einer Meldungshandlerfunktion zugeordnet werden muss.

Hinweis

Zusätzlich zu den benutzerdefinierten Meldungen behandelt ON_MESSAGE seltener vorkommende Windows-Meldungen.Weitere Informationen finden Sie im Knowledge Base-Artikel 99848: INFORMATIONEN: Verwendung ON_MESSAGE()- Makro, um von Weniger-Common-Meldungen zuzuordnen.

Weitere Informationen und Beispiele finden Sie unter Nachrichtenverarbeitungs- und Zuordnungs-Themen und Benutzerdefinierte Handler

Beispiel

#define WM_MYMESSAGE (WM_USER + 100)

BEGIN_MESSAGE_MAP(CMyWnd2, CWnd)
   ON_MESSAGE(WM_MYMESSAGE, OnMyMessage)
END_MESSAGE_MAP()

// inside the class declaration
 afx_msg LRESULT OnMyMessage(WPARAM wParam, LPARAM lParam);

LRESULT CMyWnd2::OnMyMessage(WPARAM wParam, LPARAM lParam)
{
   UNREFERENCED_PARAMETER(wParam);
   UNREFERENCED_PARAMETER(lParam);

   // Handle message here. 

   return 0;
}