CMessageMap クラス

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

更新 : 2007 年 11 月

このクラスでは、オブジェクトのメッセージマップに別のオブジェクトからアクセスできます。

class ATL_NO_VTABLE CMessageMap

解説

CMessageMap は抽象基本クラスであり、オブジェクトのメッセージマップに別のオブジェクトからアクセスできます。オブジェクトのメッセージマップを公開するには、CMessageMap の派生クラスを作成する必要があります。

ATL では、子ウィンドウおよびメッセージマップの動的チェインという 2 つの機能を CMessageMap を使ってサポートします。たとえば、CContainedWindow オブジェクトをクラスに含めるには、このクラスを CMessageMap から派生して作成する必要があります。SUBEDIT サンプルのコードを次に示します。この例の中で、CAtlEdit クラスは CComControl を通して CMessageMap から自動的に派生しています。

class ATL_NO_VTABLE CAtlEdit :
   OtherInheritedClasses
   public CComControl<CAtlEdit>
   // CComControl derives from CWindowImpl, which derives from CMessageMap
{
public:
   // Declare a contained window data member
   CContainedWindow m_ctlEdit;

   // Initialize the contained window:
   // 1. Pass "Edit" to specify that the contained 
   //    window should be based on the standard 
   //    Windows Edit box
   // 2. Pass 'this' pointer to specify that CAtlEdit 
   //    contains the message map to be used for the 
   //    contained window's message processing
   // 3. Pass the identifier of the message map. '1'
   //    identifies the alternate message map declared
   //    with ALT_MSG_MAP(1)
   CAtlEdit()
      : m_ctlEdit(_T("Edit"), this, 1)
   {
      m_bWindowOnly = TRUE;
   }

// Declare the default message map, identified by '0'
BEGIN_MSG_MAP(CAtlEdit)
   MESSAGE_HANDLER(WM_CREATE, OnCreate)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
   CHAIN_MSG_MAP(CComControl<CAtlEdit>)
// Declare an alternate message map, identified by '1'
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_CHAR, OnChar)
END_MSG_MAP()

子ウィンドウ m_EditCtrl はコンテナクラスのメッセージマップを使うので、CMessageMap から CAtlEdit が派生します。

メッセージマップの詳細については、「ATL ウィンドウクラス」の「メッセージマップ」を参照してください。