Meldungszuordnungsmakros (ATL)
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 | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
COMMAND_HANDLER | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten. |
COMMAND_ID_HANDLER | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Bezeichner des Menüelements, steuerelements oder der Zugriffstaste. |
COMMAND_RANGE_CODE_HANDLER | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
COMMAND_RANGE_HANDLER | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion zu, 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 | Ordnet eine Windows-Nachricht einer Handlerfunktion zu. |
MESSAGE_RANGE_HANDLER | Ordnet einen zusammenhängenden Bereich von Windows-Nachrichten einer Handlerfunktion zu. |
NOTIFY_CODE_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
NOTIFY_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner. |
NOTIFY_ID_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion basierend auf dem Steuerelementbezeichner zu. |
NOTIFY_RANGE_CODE_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
NOTIFY_RANGE_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion zu, 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 | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
REFLECTED_COMMAND_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten. |
REFLECTED_COMMAND_ID_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Bezeichner des Menüelements, steuerelements oder der Zugriffstaste. |
REFLECTED_COMMAND_RANGE_CODE_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
REFLECTED_COMMAND_RANGE_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
REFLECTED_NOTIFY_CODE_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
REFLECTED_NOTIFY_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner. |
REFLECTED_NOTIFY_ID_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Steuerelementbezeichner. |
REFLECTED_NOTIFY_RANGE_CODE_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
REFLECTED_NOTIFY_RANGE_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, 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 Maps.
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 | Ordnet eine Windows-Nachricht einer Handlerfunktion zu. |
MESSAGE_RANGE_HANDLER | Ordnet einen zusammenhängenden Bereich von Windows-Nachrichten einer Handlerfunktion zu. |
COMMAND_HANDLER | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten. |
COMMAND_ID_HANDLER | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Bezeichner des Menüelements, steuerelements oder der Zugriffstaste. |
COMMAND_CODE_HANDLER | Ordnet eine WM_COMMAND Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
COMMAND_RANGE_HANDLER | Ordnet einen zusammenhängenden Bereich von WM_COMMAND Nachrichten einer Handlerfunktion zu, basierend auf dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten. |
NOTIFY_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner. |
NOTIFY_ID_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion basierend auf dem Steuerelementbezeichner zu. |
NOTIFY_CODE_HANDLER | Ordnet eine WM_NOTIFY Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
NOTIFY_RANGE_HANDLER | Ordnet basierend auf dem Steuerelementbezeichner einen zusammenhängenden Bereich von WM_NOTIFY Nachrichten einer Handlerfunktion zu. |
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 | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Bezeichner des Menüelements, Steuerelements oder Zugriffstasten. |
REFLECTED_COMMAND_ID_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Bezeichner des Menüelements, steuerelements oder der Zugriffstaste. |
REFLECTED_COMMAND_CODE_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
REFLECTED_COMMAND_RANGE_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
REFLECTED_COMMAND_RANGE_CODE_HANDLER | Ordnet eine reflektierte WM_COMMAND Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
REFLECTED_NOTIFY_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Benachrichtigungscode und dem Steuerelementbezeichner. |
REFLECTED_NOTIFY_ID_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf dem Steuerelementbezeichner. |
REFLECTED_NOTIFY_CODE_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion basierend auf dem Benachrichtigungscode zu. |
REFLECTED_NOTIFY_RANGE_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, basierend auf einem zusammenhängenden Bereich von Steuerelementbezeichnern. |
REFLECTED_NOTIFY_RANGE_CODE_HANDLER | Ordnet eine reflektierte WM_NOTIFY Nachricht einer Handlerfunktion zu, 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 Maps.
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 Maps.
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
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 Maps.
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
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 Maps.
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
CMyClass
undOnPaint
eine Nachricht nicht verarbeitet, wird die Nachricht zur Verarbeitung anCMyBaseClass
die Standardnachrichtenzuordnung weitergeleitet.Wenn eine Fensterprozedur die erste alternative Nachrichtenzuordnung verwendet
CMyClass
, werden alle Nachrichten anCMyBaseClass
die Standardnachrichtenzuordnung weitergeleitet.Wenn eine Fensterprozedur die zweite alternative Nachrichtenzuordnung verwendet
CMyClass
undOnChar
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
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 Maps.
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
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 Maps.
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
CMyClass
undOnPaint
eine Nachricht nicht verarbeitet, wird die Nachricht zur Verarbeitung anm_obj
die Standardnachrichtenzuordnung weitergeleitet.Wenn eine Fensterprozedur die erste alternative Nachrichtenzuordnung verwendet
CMyClass
, werden alle Nachrichten anm_obj
die Standardnachrichtenzuordnung weitergeleitet.Wenn eine Fensterprozedur die zweite alternative Nachrichtenzuordnung verwendet
CMyClass
undOnChar
keine Nachricht verarbeitet, wird die Nachricht an die angegebene alternative Nachrichtenzuordnungm_obj
weitergeleitet. Die KlasseCMyContainedClass
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. Zum 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
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.
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 Maps.
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 Maps.
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
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.
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 Maps.
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
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.
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 Maps.
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.