NOTIFY_HANDLER

Artikel
02/26/2013

Definiert einen Eintrag in einer Meldungszuordnung.

NOTIFY_HANDLER( 
   id, 
   cd, 
   func  
)

Parameter

id
[in] Der Bezeichner des Steuerelements, das die Meldung sendet.
cd
[in] Der Benachrichtigungscode.
func
[in] Der Name der Meldungshandlerfunktion.

Hinweise

NOTIFY_HANDLER ordnet eine WM_NOTIFY Meldung an die angegebene Handlerfunktion, abhängig vom Benachrichtigungscode und das Steuerelement-ID zu.

Alle arbeiten angegeben in einem NOTIFY_HANDLER-Makro muss definiert werden, wie folgt:

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

Die Meldungszuordnungssätze bHandled zu TRUE vor NotifyHandler wird aufgerufen.Wenn NotifyHandler nicht vollständig die Meldung verarbeitet, sollte sie bHandled zu FALSE festlegen, um die weiter Verarbeitungsaufwand Meldungsanforderungen anzugeben.

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.

Zusätzlich zu NOTIFY_HANDLER können Sie MESSAGE_HANDLER verwenden, um eine Meldung WM_NOTIFY ohne Rücksicht auf einen Bezeichner oder einen Code zuzuordnen.In diesem Fall verweist MESSAGE_HANDLER(WM_NOTIFY, OnHandlerFunction) alle WM_NOTIFY Meldungen auf OnHandlerFunction.

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

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*/);
};