COMMAND_HANDLER

Artikel
02/26/2013

Definiert einen Eintrag in einer Meldungszuordnung.

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 eine Da WM_COMMAND Meldung an die angegebene Handlerfunktion, abhängig vom Benachrichtigungscode und das Steuerelement-ID 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*/);

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

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

Die Meldungszuordnungssätze bHandled zu TRUE vor CommandHandler wird aufgerufen.Wenn CommandHandler 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 COMMAND_HANDLER können Sie MESSAGE_HANDLER verwenden, um eine Meldung WM_COMMAND ohne Rücksicht auf einen Bezeichner oder einen Code zuzuordnen.In diesem Fall verweist MESSAGE_HANDLER(WM_COMMAND, OnHandlerFunction) alle WM_COMMAND Meldungen auf OnHandlerFunction.

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