Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ALT_MSG_MAP

 

Veröffentlicht: Juli 2016

Markiert den Beginn einer alternativen Meldungszuordnung.


ALT_MSG_MAP( msgMapID )

msgMapID

[in] Der Meldungszuordnungsbezeichner.

ATL identifiziert jede Meldungszuordnung durch eine Zahl. Die Standardmeldungszuordnung deklariert (mit dem BEGIN_MSG_MAP-Makro) wird durch 0 identifiziert. Eine alternative Meldungszuordnung wird durch msgMapID identifiziert.

Meldungszuordnungen werden verwendet, um die Meldungen verarbeiten, die an ein Fenster gesendet werden. Beispielsweise CContainedWindow ermöglicht Ihnen, den Bezeichner einer Meldungszuordnung im enthaltenden Objekt anzugeben. CContainedWindow::WindowProc verwendet dann diese Meldungszuordnung, um die enthaltenen Meldungen des Fensters entweder auf die entsprechende Handlerfunktion oder auf eine andere Meldungszuordnung zu verweisen. Eine Liste von Makros, die Handlerfunktionen deklarieren, finden Sie unter BEGIN_MSG_MAP.

Starten Sie immer eine Meldungszuordnung mit BEGIN_MSG_MAP. Sie können folgende alternative Meldungszuordnungen deklarieren.

Das END_MSG_MAP-Makro markiert das Ende der Meldungszuordnung. Beachten Sie, dass es immer genau eine Instanz von BEGIN_MSG_MAP und von END_MSG_MAP gibt.

Weitere Informationen zur Verwendung von Meldungszuordnungen in ATL, finden Sie unter Meldungszuordnungen.

Beispiel

Im folgenden Beispiel wird die Standardmeldungszuordnung und eine alternative Meldungszuordnung, enthaltender eine Handlerfunktion an:

BEGIN_MSG_MAP(CMyOneAltClass)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()

Im folgenden Beispiel werden zwei alternative Meldungszuordnungen an. Die Standardmeldungszuordnung ist leer.

BEGIN_MSG_MAP(CMyClass)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
ALT_MSG_MAP(2)
   MESSAGE_HANDLER(WM_CREATE, OnCreate)
END_MSG_MAP()

Anforderungen

Header: atlwin.h

Anzeigen: