ALT_MSG_MAP

Markiert den Beginn einer alternativen Meldungszuordnung.

ALT_MSG_MAP( msgMapID )

Parameter

  • msgMapID
    [in] Der Meldungszuordnungsbezeichner.

Hinweise

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

Siehe auch

Referenz

MESSAGE_HANDLER

CMessageMap-Klasse

CDynamicChain-Klasse

Weitere Ressourcen

Meldungszuordnungs-Makros (ATL)

ATL-Makros