CHAIN_MSG_MAP

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

更新 : 2007 年 11 月

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

CHAIN_MSG_MAP( theChainClass )

パラメータ

theChainClass
[入力] メッセージマップを含んでいる基本クラスの名前。

解説

CHAIN_MSG_MAP は、基本クラスの既定のメッセージマップにメッセージを送ります。既定のメッセージマップは、BEGIN_MSG_MAP で宣言しておきます。基本クラスの代替メッセージマップにメッセージを送るには、CHAIN_MSG_MAP_ALT を使用します。代替メッセージマップは、ALT_MSG_MAP で宣言しておきます。

メモ :
メッセージマップは、常に 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 つずつ生成されている必要があります。

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

使用例

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

このコードについて説明します。

ウィンドウプロシージャが CMyClass の既定のメッセージマップを使用し、OnPaint がメッセージを処理しない場合、メッセージは CMyBaseClass の既定のメッセージマップに送られ、処理されます。
ウィンドウプロシージャが CMyClass の最初の代替メッセージマップを使用している場合、メッセージはすべて CMyBaseClass の既定のメッセージマップに送られます。
ウィンドウプロシージャが CMyClass の 2 番目の代替メッセージマップを使用し、OnChar がメッセージを処理しない場合、メッセージは CMyBaseClass の指定された代替メッセージマップに送られます。CMyBaseClass は、ALT_MSG_MAP(1) を使用してこのメッセージマップを宣言しておく必要があります。