CHAIN_MSG_MAP_MEMBER

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

更新 : 2007 年 11 月

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

CHAIN_MSG_MAP_MEMBER( theChainMember )

パラメータ

theChainMember
[入力] メッセージマップを含んでいるデータメンバの名前。

解説

CHAIN_MSG_MAP_MEMBER は、データメンバの既定のメッセージマップにメッセージを送ります。既定のメッセージマップは、BEGIN_MSG_MAP で宣言しておきます。データメンバの代替メッセージマップにメッセージを送るには、CHAIN_MSG_MAP_ALT_MEMBER を使用します。代替メッセージマップは、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 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;   
   }
};

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

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