CHAIN_MSG_MAP_MEMBER

Artikel
02/26/2013

Definiert einen Eintrag in einer Meldungszuordnung.

CHAIN_MSG_MAP_MEMBER( theChainMember )

Parameter

theChainMember
[in] Der Name des Datenmembers, der die Meldungszuordnung enthält.

Hinweise

CHAIN_MSG_MAP_MEMBER Meldungen verweist auf die Standardmeldungszuordnung eines Datenmembers (deklariert mit BEGIN_MSG_MAP).Um Meldungen auf die alternative Meldungszuordnung eines Datenmembers zu verweisen (deklariert mit ALT_MSG_MAP), verwenden Sie CHAIN_MSG_MAP_ALT_MEMBER.

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.

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

Beispiel

class CMyContainerClass : public CWindowImpl<CMyContainerClass>
{
public:
   CMyContainedClass m_obj;

   BEGIN_MSG_MAP(CMyContainerClass)
      MESSAGE_HANDLER(WM_PAINT, OnPaint)
      // chain to default message map of m_obj
      CHAIN_MSG_MAP_MEMBER(m_obj)
   ALT_MSG_MAP(1)
      // chain to default message map of m_obj
      CHAIN_MSG_MAP_MEMBER(m_obj)
   ALT_MSG_MAP(2)
      MESSAGE_HANDLER(WM_CHAR, OnChar)
      // chain to alternate message map of m_obj
      CHAIN_MSG_MAP_ALT_MEMBER(m_obj, 1)
   END_MSG_MAP()

   LRESULT OnPaint(UINT /*nMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
      BOOL& /*bHandled*/)
   {
      return 0;   
   }
   LRESULT OnChar(UINT /*nMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
      BOOL& /*bHandled*/)
   {
      return 0;   
   }
};

Dieses Beispiel zeigt Folgendes:

Wenn eine Fensterprozedur die Standardmeldungszuordnung von CMyClass verwendet und OnPaint keine Meldung bearbeitet, wird die Meldung auf die Standardmeldungszuordnung von m_obj zur Verarbeitung verwiesen.
Wenn eine Fensterprozedur die erste alternative Meldungszuordnung in CMyClass verwendet, werden alle Meldungen auf die Standardmeldungszuordnung von m_obj verwiesen.
Wenn eine Fensterprozedur die zweite alternative Meldungszuordnung von CMyClass verwendet und OnChar keine Meldung bearbeitet, wird die Nachricht an die angegebene alternative Meldungszuordnung von m_obj verwiesen.- Klasse CMyContainedClass muss diese Meldungszuordnung mit ALT_MSG_MAP(1) deklariert haben.