Meldungszuordnungsmakros (ATL)

Artikel
10/12/2023

Diese Makros definieren Nachrichtenzuordnungen und Einträge.

Name	Beschreibung
ALT_MSG_MAP	Markiert den Anfang einer alternativen Nachrichtenzuordnung.
BEGIN_MSG_MAP	Markiert den Anfang der Standardnachrichtenzuordnung.
CHAIN_MSG_MAP_ALT	Ketten an eine alternative Nachrichtenzuordnung in der Basisklasse.
CHAIN_MSG_MAP_ALT_MEMBER	Ketten zu einer alternativen Nachrichtenzuordnung in einem Datenmememm der Klasse.
CHAIN_MSG_MAP	Ketten an die Standardnachrichtenzuordnung in der Basisklasse.
CHAIN_MSG_MAP_DYNAMIC	Ketten zur Laufzeit mit der Nachrichtenzuordnung in einer anderen Klasse.
CHAIN_MSG_MAP_MEMBER	Ketten mit der Standardnachrichtenzuordnung in einem Datenmememm der Klasse.
COMMAND_CODE_HANDLER	Karten eine WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
COMMAND_HANDLER	Karten einer WM_COMMAND Nachricht an eine Handlerfunktion, basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
COMMAND_ID_HANDLER	Karten einer WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
COMMAND_RANGE_CODE_HANDLER	Karten eine WM_COMMAND Nachricht an eine Handlerfunktion, basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern.
COMMAND_RANGE_HANDLER	Karten einer WM_COMMAND Nachricht an eine Handlerfunktion, basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern.
DECLARE_EMPTY_MSG_MAP	Implementiert eine leere Nachrichtenzuordnung.
DEFAULT_REFLECTION_HANDLER	Stellt einen Standardhandler für reflektierte Nachrichten bereit, die andernfalls nicht behandelt werden.
END_MSG_MAP	Markiert das Ende einer Nachrichtenzuordnung.
FORWARD_NOTIFICATIONS	Leitet Benachrichtigungen an das übergeordnete Fenster weiter.
MESSAGE_HANDLER	Karten einer Windows-Nachricht zu einer Handlerfunktion.
MESSAGE_RANGE_HANDLER	Karten einen zusammenhängenden Bereich von Windows-Nachrichten zu einer Handlerfunktion.
NOTIFY_CODE_HANDLER	Karten eine WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
NOTIFY_HANDLER	Karten eine WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner an.
NOTIFY_ID_HANDLER	Karten einer WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Steuerelementbezeichner.
NOTIFY_RANGE_CODE_HANDLER	Karten einer WM_NOTIFY Nachricht an eine Handlerfunktion, basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern.
NOTIFY_RANGE_HANDLER	Karten einer WM_NOTIFY Nachricht an eine Handlerfunktion, basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern.
REFLECT_NOTIFICATIONS	Gibt Benachrichtigungen wieder an das Fenster zurück, das sie gesendet hat.
REFLECTED_COMMAND_CODE_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
REFLECTED_COMMAND_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
REFLECTED_COMMAND_ID_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
REFLECTED_COMMAND_RANGE_CODE_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern.
REFLECTED_COMMAND_RANGE_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern.
REFLECTED_NOTIFY_CODE_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
REFLECTED_NOTIFY_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner.
REFLECTED_NOTIFY_ID_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Steuerelementbezeichner.
REFLECTED_NOTIFY_RANGE_CODE_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern.
REFLECTED_NOTIFY_RANGE_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern.

Anforderungen

Kopfzeile: atlwin.h

ALT_MSG_MAP

Markiert den Anfang einer alternativen Nachrichtenzuordnung.

ALT_MSG_MAP(msgMapID)

Parameter

msgMapID
[in] Der Nachrichtenzuordnungsbezeichner.

Hinweise

ATL identifiziert jede Nachrichtenzuordnung anhand einer Zahl. Die Standardnachrichtenzuordnung (deklariert mit dem BEGIN_MSG_MAP-Makro) wird durch 0 identifiziert. Eine alternative Nachrichtenzuordnung wird durch msgMapID identifiziert.

Nachrichtenzuordnungen werden verwendet, um Nachrichten zu verarbeiten, die an ein Fenster gesendet werden. Mit CContainedWindow können Sie beispielsweise den Bezeichner einer Nachrichtenzuordnung im enthaltenden Objekt angeben. CContainedWindow::WindowProc verwendet dann diese Nachrichtenzuordnung, um die Nachrichten des enthaltenen Fensters entweder an die entsprechende Handlerfunktion oder an eine andere Nachrichtenzuordnung zu leiten. Eine Liste der Makros, die Handlerfunktionen deklarieren, finden Sie unter BEGIN_MSG_MAP.

Beginnen Sie immer eine Nachrichtenzuordnung mit BEGIN_MSG_MAP. Anschließend können Sie nachfolgende alternative Nachrichtenzuordnungen deklarieren.

Das END_MSG_MAP Makro markiert das Ende der Nachrichtenzuordnung. Beachten Sie, dass immer genau eine Instanz von BEGIN_MSG_MAP und END_MSG_MAP vorhanden ist.

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Beispiel

Das folgende Beispiel zeigt die Standardnachrichtenzuordnung und eine alternative Nachrichtenzuordnung, die jeweils eine Handlerfunktion enthält:

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

Das nächste Beispiel zeigt zwei alternative Nachrichtenzuordnungen. Die Standardnachrichtenzuordnung 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

Kopfzeile: atlwin.h

BEGIN_MSG_MAP

Markiert den Anfang der Standardnachrichtenzuordnung.

BEGIN_MSG_MAP(theClass)

Parameter

theClass
[in] Der Name der Klasse, die die Nachrichtenzuordnung enthält.

Hinweise

CWindowImpl::WindowProc verwendet die Standardnachrichtenzuordnung zum Verarbeiten von Nachrichten, die an das Fenster gesendet werden. Die Nachrichtenzuordnung leitet Nachrichten entweder zur entsprechenden Handlerfunktion oder zu einer anderen Nachrichtenzuordnung weiter.

Die folgenden Makros ordnen eine Nachricht einer Handlerfunktion zu. Diese Funktion muss in theClass definiert werden.

Makro	Beschreibung
MESSAGE_HANDLER	Karten einer Windows-Nachricht zu einer Handlerfunktion.
MESSAGE_RANGE_HANDLER	Karten einen zusammenhängenden Bereich von Windows-Nachrichten zu einer Handlerfunktion.
COMMAND_HANDLER	Karten einer WM_COMMAND Nachricht an eine Handlerfunktion, basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
COMMAND_ID_HANDLER	Karten einer WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
COMMAND_CODE_HANDLER	Karten eine WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
COMMAND_RANGE_HANDLER	Karten einen zusammenhängenden Bereich von WM_COMMAND Nachrichten an eine Handlerfunktion basierend auf dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
NOTIFY_HANDLER	Karten eine WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner an.
NOTIFY_ID_HANDLER	Karten einer WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Steuerelementbezeichner.
NOTIFY_CODE_HANDLER	Karten eine WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
NOTIFY_RANGE_HANDLER	Karten einen zusammenhängenden Bereich von WM_NOTIFY Nachrichten an eine Handlerfunktion basierend auf dem Steuerelementbezeichner.

Mit den folgenden Makros werden Nachrichten an eine andere Nachrichtenzuordnung geleitet. Dieser Prozess wird als "Verkettung" bezeichnet.

Makro	Beschreibung
CHAIN_MSG_MAP	Ketten an die Standardnachrichtenzuordnung in der Basisklasse.
CHAIN_MSG_MAP_MEMBER	Ketten mit der Standardnachrichtenzuordnung in einem Datenmememm der Klasse.
CHAIN_MSG_MAP_ALT	Ketten an eine alternative Nachrichtenzuordnung in der Basisklasse.
CHAIN_MSG_MAP_ALT_MEMBER	Ketten zu einer alternativen Nachrichtenzuordnung in einem Datenmememm der Klasse.
CHAIN_MSG_MAP_DYNAMIC	Ketten zur Standardnachrichtenzuordnung in einer anderen Klasse zur Laufzeit.

Die folgenden Makros führen direkte "reflektierte" Nachrichten aus dem übergeordneten Fenster aus. Beispielsweise sendet ein Steuerelement Benachrichtigungen normalerweise zur Verarbeitung an das übergeordnete Fenster, aber das übergeordnete Fenster kann die Nachricht wieder an das Steuerelement zurückgeben.

Makro	Beschreibung
REFLECTED_COMMAND_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
REFLECTED_COMMAND_ID_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten.
REFLECTED_COMMAND_CODE_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
REFLECTED_COMMAND_RANGE_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern.
REFLECTED_COMMAND_RANGE_CODE_HANDLER	Karten eine reflektierte WM_COMMAND Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern.
REFLECTED_NOTIFY_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner.
REFLECTED_NOTIFY_ID_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Steuerelementbezeichner.
REFLECTED_NOTIFY_CODE_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode.
REFLECTED_NOTIFY_RANGE_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern.
REFLECTED_NOTIFY_RANGE_CODE_HANDLER	Karten eine reflektierte WM_NOTIFY Nachricht an eine Handlerfunktion basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern.

Beispiel

class CMyExtWindow : public CMyBaseWindow
{
public:
   BEGIN_MSG_MAP(CMyExtWindow)
      MESSAGE_HANDLER(WM_PAINT, OnPaint)
      MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
      CHAIN_MSG_MAP(CMyBaseWindow)
   END_MSG_MAP()

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

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

Wenn ein CMyExtWindow Objekt eine WM_PAINT Nachricht empfängt, wird die Nachricht zur tatsächlichen Verarbeitung weitergeleitet CMyExtWindow::OnPaint . Wenn OnPaint angibt, dass die Nachricht eine weitere Verarbeitung erfordert, wird die Nachricht dann an die Standardnachrichtenzuordnung weitergeleitet.CMyBaseWindow

Zusätzlich zur Standardnachrichtenzuordnung können Sie eine alternative Nachrichtenzuordnung mit ALT_MSG_MAP definieren. Beginnen Sie immer eine Nachrichtenzuordnung mit BEGIN_MSG_MAP. Anschließend können Sie nachfolgende alternative Nachrichtenzuordnungen deklarieren. Das folgende Beispiel zeigt die Standardnachrichtenzuordnung und eine alternative Nachrichtenzuordnung, die jeweils eine Handlerfunktion enthält:

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

Das nächste Beispiel zeigt zwei alternative Nachrichtenzuordnungen. Die Standardnachrichtenzuordnung 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()

Das END_MSG_MAP Makro markiert das Ende der Nachrichtenzuordnung. Beachten Sie, dass immer genau eine Instanz von BEGIN_MSG_MAP und END_MSG_MAP vorhanden ist.

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Anforderungen

Kopfzeile: atlwin.h

CHAIN_MSG_MAP_ALT

Definiert einen Eintrag in einer Nachrichtenzuordnung.

CHAIN_MSG_MAP_ALT(theChainClass, msgMapID)

Parameter

theChainClass
[in] Der Name der Basisklasse, die die Nachrichtenzuordnung enthält.

msgMapID
[in] Der Nachrichtenzuordnungsbezeichner.

Hinweise

CHAIN_MSG_MAP_ALT leitet Nachrichten an eine alternative Nachrichtenzuordnung in einer Basisklasse weiter. Sie müssen diese alternative Nachrichtenzuordnung mit ALT_MSG_MAP(msgMapID)deklariert haben. Verwenden Sie CHAIN_MSG_MAP, um Nachrichten an die Standardnachrichtenzuordnung einer Basisklasse zu leiten (deklariert mit BEGIN_MSG_MAP). Ein Beispiel finden Sie unter CHAIN_MSG_MAP.

Hinweis

Beginnen Sie immer eine Nachrichtenzuordnung mit BEGIN_MSG_MAP. Anschließend können Sie nachfolgende alternative Nachrichtenzuordnungen mit ALT_MSG_MAP deklarieren. Das END_MSG_MAP Makro markiert das Ende der Nachrichtenzuordnung. Jede Nachrichtenzuordnung muss genau eine Instanz von BEGIN_MSG_MAP und END_MSG_MAP haben.

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Anforderungen

Kopfzeile: atlwin.h

CHAIN_MSG_MAP_ALT_MEMBER

Definiert einen Eintrag in einer Nachrichtenzuordnung.

CHAIN_MSG_MAP_ALT_MEMBER(theChainMember, msgMapID)

Parameter

theChainMember
[in] Der Name des Datenelements, das die Nachrichtenzuordnung enthält.

msgMapID
[in] Der Nachrichtenzuordnungsbezeichner.

Hinweise

CHAIN_MSG_MAP_ALT_MEMBER leitet Nachrichten an eine alternative Nachrichtenzuordnung in einem Datenelement weiter. Sie müssen diese alternative Nachrichtenzuordnung mit ALT_MSG_MAP(msgMapID)deklariert haben. Verwenden Sie CHAIN_MSG_MAP_MEMBER, um Nachrichten an die Standardnachrichtenzuordnung eines Datenmitglieds zu leiten (deklariert mit BEGIN_MSG_MAP). Ein Beispiel finden Sie unter CHAIN_MSG_MAP_MEMBER.

Hinweis

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Anforderungen

Kopfzeile: atlwin.h

CHAIN_MSG_MAP

Definiert einen Eintrag in einer Nachrichtenzuordnung.

CHAIN_MSG_MAP(theChainClass)

Parameter

theChainClass
[in] Der Name der Basisklasse, die die Nachrichtenzuordnung enthält.

Hinweise

CHAIN_MSG_MAP leitet Nachrichten an die Standardnachrichtenzuordnung einer Basisklasse weiter (deklariert mit BEGIN_MSG_MAP). Verwenden Sie CHAIN_MSG_MAP_ALT, um Nachrichten an die alternative Nachrichtenzuordnung einer Basisklasse zu leiten (deklariert mit ALT_MSG_MAP).

Hinweis

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Beispiel

class CMyExtClass : public CMyBaseClass
{
public:
  BEGIN_MSG_MAP(CMyExtClass)
     MESSAGE_HANDLER(WM_PAINT, OnPaint)
     // chain to default message map in CMyBaseClass
     CHAIN_MSG_MAP(CMyBaseClass)
  ALT_MSG_MAP(1)
     // chain to first alternative message map in CMyBaseClass
     CHAIN_MSG_MAP(CMyBaseClass)
  ALT_MSG_MAP(2)
     MESSAGE_HANDLER(WM_CHAR, OnChar)
     // chain to alternate message map in CMyBaseClass
     CHAIN_MSG_MAP_ALT(CMyBaseClass, 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;   
   }
};

In diesem Beispiel wird Folgendes veranschaulicht:

Wenn eine Fensterprozedur die Standardnachrichtenzuordnung verwendet CMyClassund OnPaint eine Nachricht nicht verarbeitet, wird die Nachricht zur Verarbeitung an CMyBaseClassdie Standardnachrichtenzuordnung weitergeleitet.
Wenn eine Fensterprozedur die erste alternative Nachrichtenzuordnung verwendet CMyClass, werden alle Nachrichten an CMyBaseClassdie Standardnachrichtenzuordnung weitergeleitet.
Wenn eine Fensterprozedur die zweite alternative Nachrichtenzuordnung verwendet CMyClassund OnChar keine Nachricht verarbeitet, wird die Nachricht an die angegebene alternative Nachrichtenzuordnung weitergeleitet.CMyBaseClass CMyBaseClass muss diese Nachrichtenzuordnung mit ALT_MSG_MAP(1) deklariert haben.

Anforderungen

Kopfzeile: atlwin.h

CHAIN_MSG_MAP_DYNAMIC

Definiert einen Eintrag in einer Nachrichtenzuordnung.

CHAIN_MSG_MAP_DYNAMIC(dynaChainID)

Parameter

dynaChainID
[in] Der eindeutige Bezeichner für die Nachrichtenzuordnung eines Objekts.

Hinweise

CHAIN_MSG_MAP_DYNAMIC leitet Nachrichten zur Laufzeit an die Standardnachrichtenzuordnung in einem anderen Objekt weiter. Das Objekt und die zugehörige Nachrichtenzuordnung sind dynaChainID zugeordnet, die Sie über CDynamicChain::SetChainEntry definieren. Sie müssen Ihren Kurs ableiten CDynamicChain , um CHAIN_MSG_MAP_DYNAMIC zu verwenden. Ein Beispiel finden Sie in der CDynamicChain-Übersicht .

Hinweis

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Anforderungen

Kopfzeile: atlwin.h

CHAIN_MSG_MAP_MEMBER

Definiert einen Eintrag in einer Nachrichtenzuordnung.

CHAIN_MSG_MAP_MEMBER(theChainMember)

Parameter

theChainMember
[in] Der Name des Datenelements, das die Nachrichtenzuordnung enthält.

Hinweise

CHAIN_MSG_MAP_MEMBER leitet Nachrichten an die Standardnachrichtenzuordnung eines Datenmitglieds weiter (deklariert mit BEGIN_MSG_MAP). Verwenden Sie CHAIN_MSG_MAP_ALT_MEMBER, um Nachrichten an die alternative Nachrichtenzuordnung eines Datenmitglieds zu leiten (deklariert mit ALT_MSG_MAP).

Hinweis

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

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;   
   }
};

In diesem Beispiel wird Folgendes veranschaulicht:

Wenn eine Fensterprozedur die Standardnachrichtenzuordnung verwendet CMyClassund OnPaint eine Nachricht nicht verarbeitet, wird die Nachricht zur Verarbeitung an m_objdie Standardnachrichtenzuordnung weitergeleitet.
Wenn eine Fensterprozedur die erste alternative Nachrichtenzuordnung verwendet CMyClass, werden alle Nachrichten an m_objdie Standardnachrichtenzuordnung weitergeleitet.
Wenn eine Fensterprozedur die zweite alternative Nachrichtenzuordnung verwendet CMyClassund OnChar keine Nachricht verarbeitet, wird die Nachricht an die angegebene alternative Nachrichtenzuordnung m_objweitergeleitet. Die Klasse CMyContainedClass muss diese Nachrichtenzuordnung mit ALT_MSG_MAP(1) deklariert haben.

Anforderungen

Kopfzeile: atlwin.h

COMMAND_CODE_HANDLER

Ähnlich wie COMMAND_HANDLER, wird jedoch eine WM_COMMAND Nachricht nur basierend auf dem Benachrichtigungscode zugeordnet.

COMMAND_CODE_HANDLER(code, func)

Parameter

code
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

COMMAND_HANDLER

Definiert einen Eintrag in einer Nachrichtenzuordnung.

COMMAND_HANDLER(id, code, func)

Parameter

id
[in] Der Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste.

code
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

COMMAND_HANDLER ordnet basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner eine WM_COMMAND Nachricht der angegebenen Handlerfunktion zu. Beispiel:

class ATL_NO_VTABLE CPolyProp :
   public CComObjectRootEx<CComSingleThreadModel>,
   public CComCoClass<CPolyProp, &CLSID_PolyProp>,
   public IPropertyPageImpl<CPolyProp>,
   public CDialogImpl<CPolyProp>
{
public:
BEGIN_COM_MAP(CPolyProp)
   COM_INTERFACE_ENTRY(IPropertyPage)
END_COM_MAP()

BEGIN_MSG_MAP(CPolyProp)
   COMMAND_HANDLER(IDC_SIDES, EN_CHANGE, OnEnChangeSides)
   CHAIN_MSG_MAP(IPropertyPageImpl<CPolyProp>)
END_MSG_MAP()

   // When a CPolyProp object receives a WM_COMMAND message identified 
   // by IDC_SIDES and EN_CHANGE, the message is directed to 
   // CPolyProp::OnEnChangeSides for the actual processing.
   LRESULT OnEnChangeSides(WORD /*wNotifyCode*/, WORD /*wID*/, HWND /*hWndCtl*/, 
      BOOL& /*bHandled*/);

Jede in einem COMMAND_HANDLER Makro angegebene Funktion muss wie folgt definiert werden:

LRESULT CommandHandler(WORD wNotifyCode, WORD wID, HWND hWndCtl, BOOL& bHandled);

Die Nachrichtenzuordnung wird auf TRUE festgelegt bHandled , bevor CommandHandler sie aufgerufen wird. Wenn CommandHandler die Nachricht nicht vollständig verarbeitet wird, sollte sie auf FALSE festgelegt bHandled werden, um anzugeben, dass die Nachricht weiter verarbeitet werden muss.

Hinweis

Zusätzlich zu COMMAND_HANDLER können Sie MESSAGE_HANDLER verwenden, um eine WM_COMMAND Nachricht ohne Berücksichtigung eines Bezeichners oder Codes zuzuordnen. In diesem Fall MESSAGE_HANDLER(WM_COMMAND, OnHandlerFunction) werden alle WM_COMMAND Nachrichten an OnHandlerFunction.

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Anforderungen

Kopfzeile: atlwin.h

COMMAND_ID_HANDLER

Ähnlich wie COMMAND_HANDLER wird eine WM_COMMAND Nachricht jedoch nur anhand des Bezeichners des Menüelements, steuerelements oder der Zugriffstaste zugeordnet.

COMMAND_ID_HANDLER(id, func)

Parameter

id
[in] Der Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste, das die Nachricht sendet.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

COMMAND_RANGE_CODE_HANDLER

Ähnlich wie COMMAND_RANGE_HANDLER ordnet WM_COMMAND Nachrichten jedoch einem bestimmten Benachrichtigungscode aus einem Bereich von Steuerelementen einer einzelnen Handlerfunktion zu.

COMMAND_RANGE_CODE_HANDLER(idFirst, idLast, code, func)

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

code
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

Dieser Bereich basiert auf dem Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste, die die Nachricht sendet.

Anforderungen

Kopfzeile: atlwin.h

COMMAND_RANGE_HANDLER

Ähnlich wie COMMAND_HANDLER, werden jedoch WM_COMMAND Nachrichten aus einem Bereich von Steuerelementen einer einzelnen Handlerfunktion zugeordnet.

COMMAND_RANGE_HANDLER( idFirst, idLast, func)

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

Dieser Bereich basiert auf dem Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste, die die Nachricht sendet.

Anforderungen

Kopfzeile: atlwin.h

DECLARE_EMPTY_MSG_MAP

Deklariert eine leere Nachrichtenzuordnung.

DECLARE_EMPTY_MSG_MAP()

Hinweise

DECLARE_EMPTY_MSG_MAP ist ein Benutzerfreundlichkeitsmakro, das die Makros BEGIN_MSG_MAP aufruft und END_MSG_MAP, um eine leere Nachrichtenzuordnung zu erstellen:

BEGIN_MSG_MAP(CExample)
END_MSG_MAP()

DEFAULT_REFLECTION_HANDLER

Stellt einen Standardhandler für das untergeordnete Fenster (Steuerelement) bereit, das reflektierte Nachrichten empfängt; Der Handler übergibt unbehandelte Nachrichten ordnungsgemäß an DefWindowProc.

DEFAULT_REFLECTION_HANDLER()

Anforderungen

Kopfzeile: atlwin.h

END_MSG_MAP

Markiert das Ende einer Nachrichtenzuordnung.

END_MSG_MAP()

Hinweise

Verwenden Sie immer das BEGIN_MSG_MAP-Makro , um den Anfang einer Nachrichtenzuordnung zu markieren. Verwenden Sie ALT_MSG_MAP , um nachfolgende alternative Nachrichtenzuordnungen zu deklarieren.

Beachten Sie, dass immer genau eine Instanz von BEGIN_MSG_MAP und END_MSG_MAP vorhanden ist.

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Beispiel

Das folgende Beispiel zeigt die Standardnachrichtenzuordnung und eine alternative Nachrichtenzuordnung, die jeweils eine Handlerfunktion enthält:

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

Das nächste Beispiel zeigt zwei alternative Nachrichtenzuordnungen. Die Standardnachrichtenzuordnung 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

Kopfzeile: atlwin.h

FORWARD_NOTIFICATIONS

Leitet Benachrichtigungen an das übergeordnete Fenster weiter.

FORWARD_NOTIFICATIONS()

Hinweise

Geben Sie dieses Makro als Teil der Nachrichtenzuordnung an.

Anforderungen

Kopfzeile: atlwin.h

MESSAGE_HANDLER

Definiert einen Eintrag in einer Nachrichtenzuordnung.

MESSAGE_HANDLER( msg, func )

Parameter

msg
[in] Die Windows-Nachricht.

func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

MESSAGE_HANDLER ordnet eine Windows-Nachricht der angegebenen Handlerfunktion zu.

Jede in einem MESSAGE_HANDLER Makro angegebene Funktion muss wie folgt definiert werden:

LRESULT MessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled);

Die Nachrichtenzuordnung wird auf TRUE festgelegt bHandled , bevor MessageHandler sie aufgerufen wird. Wenn MessageHandler die Nachricht nicht vollständig verarbeitet wird, sollte sie auf FALSE festgelegt bHandled werden, um anzugeben, dass die Nachricht weiter verarbeitet werden muss.

Hinweis

Zusätzlich zu MESSAGE_HANDLER können Sie COMMAND_HANDLER und NOTIFY_HANDLER verwenden, um WM_COMMAND bzw . WM_NOTIFY Nachrichten zuzuordnen.

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

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

Kopfzeile: atlwin.h

MESSAGE_RANGE_HANDLER

Ähnlich wie MESSAGE_HANDLER, ordnet jedoch einen Bereich von Windows-Nachrichten einer einzelnen Handlerfunktion zu.

MESSAGE_RANGE_HANDLER( msgFirst, msgLast, func )

Parameter

msgFirst
[in] Markiert den Anfang eines zusammenhängenden Nachrichtenbereichs.

msgLast
[in] Markiert das Ende eines zusammenhängenden Nachrichtenbereichs.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

NOTIFY_CODE_HANDLER

Ähnlich wie NOTIFY_HANDLER, wird jedoch eine WM_NOTIFY Nachricht nur basierend auf dem Benachrichtigungscode zugeordnet.

NOTIFY_CODE_HANDLER(cd, func)

Parameter

cd
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

NOTIFY_HANDLER

Definiert einen Eintrag in einer Nachrichtenzuordnung.

NOTIFY_HANDLER( id, cd, func )

Parameter

id
[in] Der Bezeichner des Steuerelements, das die Nachricht sendet.

cd
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

NOTIFY_HANDLER ordnet basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner eine WM_NOTIFY Nachricht der angegebenen Handlerfunktion zu.

Jede in einem NOTIFY_HANDLER Makro angegebene Funktion muss wie folgt definiert werden:

LRESULT NotifyHandler(int idCtrl, LPNMHDR pnmh, BOOL& bHandled);

Die Nachrichtenzuordnung wird auf TRUE festgelegt bHandled , bevor NotifyHandler sie aufgerufen wird. Wenn NotifyHandler die Nachricht nicht vollständig verarbeitet wird, sollte sie auf FALSE festgelegt bHandled werden, um anzugeben, dass die Nachricht weiter verarbeitet werden muss.

Hinweis

Zusätzlich zu NOTIFY_HANDLER können Sie MESSAGE_HANDLER verwenden, um eine WM_NOTIFY Nachricht ohne Kennung oder Code zuzuordnen. In diesem Fall MESSAGE_HANDLER(WM_NOTIFY, OnHandlerFunction) werden alle WM_NOTIFY Nachrichten an OnHandlerFunction.

Weitere Informationen zur Verwendung von Nachrichtenzuordnungen in ATL finden Sie unter Message Karten.

Beispiel

class CMyDialog2 : public CDialogImpl<CMyDialog2>
{
public:
   enum { IDD = IDD_MYDLG };

   BEGIN_MSG_MAP(CMyDialog2)
      NOTIFY_HANDLER(IDC_TREE1, NM_CLICK, OnNMClickTree1)
   END_MSG_MAP()

public:
   // When a CMyDialog2 object receives a WM_NOTIFY message 
   // identified by IDC_TREE1 and NM_CLICK, the message is 
   // directed to CMyDialog2::OnNMClickTree1 for the actual
   // processing.
   LRESULT OnNMClickTree1(int /*idCtrl*/, LPNMHDR pNMHDR, BOOL& /*bHandled*/);
};

Anforderungen

Kopfzeile: atlwin.h

NOTIFY_ID_HANDLER

Ähnlich wie NOTIFY_HANDLER, wird jedoch eine WM_NOTIFY Nachricht nur basierend auf dem Steuerelementbezeichner zugeordnet.

NOTIFY_ID_HANDLER( id, func )

Parameter

id
[in] Der Bezeichner des Steuerelements, das die Nachricht sendet.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

NOTIFY_RANGE_CODE_HANDLER

Ähnlich wie NOTIFY_RANGE_HANDLER ordnet WM_NOTIFY Nachrichten jedoch einem bestimmten Benachrichtigungscode aus einem Bereich von Steuerelementen einer einzelnen Handlerfunktion zu.

NOTIFY_RANGE_CODE_HANDLER( idFirst, idLast, cd, func )

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

cd
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

Dieser Bereich basiert auf dem Bezeichner des Steuerelements, das die Nachricht sendet.

Anforderungen

Kopfzeile: atlwin.h

NOTIFY_RANGE_HANDLER

Ähnlich wie NOTIFY_HANDLER, werden jedoch WM_NOTIFY Nachrichten aus einem Bereich von Steuerelementen einer einzelnen Handlerfunktion zugeordnet.

NOTIFY_RANGE_HANDLER( idFirst, idLast, func )

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

Dieser Bereich basiert auf dem Bezeichner des Steuerelements, das die Nachricht sendet.

Anforderungen

Kopfzeile: atlwin.h

REFLECT_NOTIFICATIONS

Gibt Benachrichtigungen zurück an das untergeordnete Fenster (Steuerelement) zurück, das sie gesendet hat.

REFLECT_NOTIFICATIONS()

Hinweise

Geben Sie dieses Makro als Teil der Nachrichtenzuordnung des übergeordneten Fensters an.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_COMMAND_CODE_HANDLER

Ähnlich wie COMMAND_CODE_HANDLER, werden jedoch Befehle aus dem übergeordneten Fenster zugeordnet.

REFLECTED_COMMAND_CODE_HANDLER( code, func )

Parameter

code
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_COMMAND_HANDLER

Ähnlich wie COMMAND_HANDLER, werden jedoch Befehle aus dem übergeordneten Fenster zugeordnet.

REFLECTED_COMMAND_HANDLER( id, code, func )

Parameter

id
[in] Der Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste.

code
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_COMMAND_ID_HANDLER

Ähnlich wie COMMAND_ID_HANDLER, werden jedoch Befehle aus dem übergeordneten Fenster zugeordnet.

REFLECTED_COMMAND_ID_HANDLER( id, func )

Parameter

id
[in] Der Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_COMMAND_RANGE_CODE_HANDLER

Ähnlich wie COMMAND_RANGE_CODE_HANDLER, werden jedoch Befehle aus dem übergeordneten Fenster zugeordnet.

REFLECTED_COMMAND_RANGE_CODE_HANDLER( idFirst, idLast, code, func )

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

code
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_COMMAND_RANGE_HANDLER

Ähnlich wie COMMAND_RANGE_HANDLER, werden jedoch Befehle aus dem übergeordneten Fenster zugeordnet.

REFLECTED_COMMAND_RANGE_HANDLER( idFirst, idLast, func )

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_NOTIFY_CODE_HANDLER

Ähnlich wie NOTIFY_CODE_HANDLER, werden jedoch Benachrichtigungen aus dem übergeordneten Fenster zugeordnet.

REFLECTED_NOTIFY_CODE_HANDLER_EX( cd, func )

Parameter

cd
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_NOTIFY_HANDLER

Ähnlich wie NOTIFY_HANDLER, werden jedoch Benachrichtigungen aus dem übergeordneten Fenster zugeordnet.

REFLECTED_NOTIFY_HANDLER( id, cd, func )

Parameter

id
[in] Der Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste.

cd
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_NOTIFY_ID_HANDLER

Ähnlich wie NOTIFY_ID_HANDLER, werden jedoch Benachrichtigungen aus dem übergeordneten Fenster zugeordnet.

REFLECTED_NOTIFY_ID_HANDLER( id, func )

Parameter

id
[in] Der Bezeichner des Menüelements, des Steuerelements oder der Zugriffstaste.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_NOTIFY_RANGE_CODE_HANDLER

Ähnlich wie NOTIFY_RANGE_CODE_HANDLER, werden jedoch Benachrichtigungen aus dem übergeordneten Fenster zugeordnet.

REFLECTED_NOTIFY_RANGE_CODE_HANDLER( idFirst, idLast, cd, func )

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

cd
[in] Der Benachrichtigungscode.

func
[in] Der Name der Meldungshandlerfunktion.

Anforderungen

Kopfzeile: atlwin.h

REFLECTED_NOTIFY_RANGE_HANDLER

Ähnlich wie NOTIFY_RANGE_HANDLER werden jedoch Benachrichtigungen aus dem übergeordneten Fenster zugeordnet.

REFLECTED_NOTIFY_RANGE_HANDLER( idFirst, idLast, func )

Parameter

idFirst
[in] Markiert den Anfang eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

idLast
[in] Markiert das Ende eines zusammenhängenden Bereichs von Steuerelementbezeichnern.

func
[in] Der Name der Meldungshandlerfunktion.

Siehe auch

Makros