COMMAND_HANDLER

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

メッセージマップにエントリを定義します。

COMMAND_HANDLER( id, code, func )

パラメータ

id
[入力] メニュー項目、コントロール、またはアクセラレータの識別子。
code
[入力] 通知コード。
func
[入力] メッセージハンドラ関数の名前。

解説

COMMAND_HANDLER は、通知コードとコントロール ID に基づいて、WM_COMMAND メッセージを指定されたハンドラ関数に割り当てます。次に例を示します。

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

COMMAND_HANDLER マクロに指定する関数は、すべて次のように定義する必要があります。

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

CommandHandler が呼び出される前に、メッセージマップでは bHandled が TRUE に設定されます。CommandHandler は、メッセージをすべて処理できない場合、bHandled を FALSE に設定して、メッセージ処理がさらに必要であることを示す必要があります。

メモ :
メッセージマップは、常に BEGIN_MSG_MAP で開始します。開始した後、ALT_MSG_MAP を使って、さらに代替メッセージマップを宣言することもできます。END_MSG_MAP マクロは、メッセージマップの終了位置を示します。どのメッセージマップにも、BEGIN_MSG_MAP と END_MSG_MAP のインスタンスが 1 つずつ生成されている必要があります。

メッセージマップは、常に BEGIN_MSG_MAP で開始します。開始した後、ALT_MSG_MAP を使って、さらに代替メッセージマップを宣言することもできます。END_MSG_MAP マクロは、メッセージマップの終了位置を示します。どのメッセージマップにも、BEGIN_MSG_MAP と END_MSG_MAP のインスタンスが 1 つずつ生成されている必要があります。

COMMAND_HANDLER のほかに、MESSAGE_HANDLER を使用して、ID やコードに関係なく、WM_COMMAND メッセージを割り当てることもできます。この場合、MESSAGE_HANDLER(WM_COMMAND, OnHandlerFunction) は、すべての WM_COMMAND メッセージを OnHandlerFunction に送ります。

ATL でのメッセージマップの使い方の詳細については、「メッセージマップ」を参照してください。