MESSAGE_HANDLER
Definiert einen Eintrag in einer Meldungszuordnung.
MESSAGE_HANDLER(
msg,
func
)
Parameter
msg
[in] Die Windows-Meldung.func
[in] Der Name der Meldungshandlerfunktion.
Hinweise
MESSAGE_HANDLER ordnet eine Windows-Meldung zur angegebenen Handlerfunktion zu.
Alle arbeiten angegeben in einem MESSAGE_HANDLER-Makro muss definiert werden, wie folgt:
LRESULT MessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled);
Die Meldungszuordnungssätze bHandled zu TRUE vor MessageHandler wird aufgerufen.Wenn MessageHandler nicht vollständig die Meldung verarbeitet, sollte sie bHandled zu FALSE festlegen, um die weiter Verarbeitungsaufwand Meldungsanforderungen anzugeben.
.gif "Hinweis") Hinweis |
|---|
Starten Sie immer eine Meldungszuordnung mit BEGIN_MSG_MAP.Sie können folgende alternative Meldungszuordnungen mit ALT_MSG_MAP deklarieren.Das END_MSG_MAP-Makro markiert das Ende der Meldungszuordnung.Jede Meldungszuordnung muss eine Instanz von BEGIN_MSG_MAP und von END_MSG_MAP genau haben. |
Zusätzlich zu MESSAGE_HANDLER können Sie COMMAND_HANDLER und NOTIFY_HANDLER verwenden, um Da WM_COMMAND und WM_NOTIFY Meldungen zuzuordnen, bzw.
Weitere Informationen zur Verwendung von Meldungszuordnungen in ATL, finden Sie unter Meldungszuordnungen.
Beispiel
class CMyBaseWindow : public CWindowImpl<CMyBaseWindow>
{
public:
BEGIN_MSG_MAP(CMyBaseWindow)
MESSAGE_HANDLER(WM_CREATE, OnCreate)
END_MSG_MAP()
// When a CMyBaseWindow object receives a WM_CREATE message, the message
// is directed to CMyBaseWindow::OnCreate for the actual processing.
LRESULT OnCreate(UINT /*nMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/,
BOOL& /*bHandled*/)
{
return 0;
}
};
Anforderungen
Header: atlwin.h