CMessageMap 類別

這個類別可讓另一個物件存取物件的訊息對應。

語法

class ATL_NO_VTABLE CMessageMap

成員

公用方法

備註

CMessageMap 是抽象基類，可讓另一個物件存取物件的訊息對應。 為了讓物件公開其訊息對應，其類別必須衍生自 CMessageMap。

ATL 使用 CMessageMap 來支援自主視窗和動態訊息對應鏈結。 例如，任何包含 CContainedWindow 物件的類別都必須衍生自 CMessageMap。 下列程式代碼取自 SUBEDIT 範例。 透過 CComControl，類別 CAtlEdit 會自動衍生自 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使用包含類別中的訊息對應， CAtlEdit 衍生自 CMessageMap。

如需訊息對應的詳細資訊，請參閱 一文中的訊息對應 。

需求

標頭： atlwin.h

CMessageMap：:P rocessWindowMessage

存取衍生類別中 CMessageMapdwMsgMapID 所識別的訊息對應。

virtual BOOL ProcessWindowMessage(
    HWND hWnd,
    UINT uMsg,
    WPARAM wParam,
    LPARAM lParam,
    LRESULT& lResult,
    DWORD dwMsgMapID) = 0;

參數

hWnd
[in]接收訊息之視窗的句柄。

uMsg
[in]傳送至視窗的訊息。

wParam
[in]其他訊息特定資訊。

lParam
[in]其他訊息特定資訊。

lResult
[out]訊息處理的結果。

dwMsgMapID
[in]將處理訊息之訊息對應的標識碼。 使用 BEGIN_MSG_MAP 宣告的預設訊息對應會以 0 來識別。 以 ALT_MSG_MAP（msgMapID） 宣告的替代訊息對應是由識別msgMapID。

傳回值

如果訊息已完全處理，則為TRUE;否則為 FALSE。

備註

由 CContainedWindow 物件的視窗程式或動態鏈結至訊息對應的物件呼叫。

另請參閱

CDynamicChain 類別
BEGIN_MSG_MAP
ALT_MSG_MAP（msgMapID）
類別概觀