ALT_MSG_MAP

標記中使用一個替代的訊息對應的開頭。

ALT_MSG_MAP( msgMapID )

參數

  • msgMapID
    [in] 的訊息對應識別項。

備註

ATL 以數字識別每個訊息對應。預設的訊息對應 (宣告 BEGIN_MSG_MAP 巨集) 是由 0 所識別。替代的訊息對應是由 msgMapID決定的。

訊息對應來處理傳送至視窗。例如, CContainedWindow 包含在中的物件可讓您指定訊息對應的識別項。然後使用這個CContainedWindow::WindowProc 訊息對應指示所包含之視窗的訊息至適當的處理常式函式或另一個訊息對應。如需宣告處理常式函式巨集的清單,請參閱 BEGIN_MSG_MAP

BEGIN_MSG_MAP永遠啟動訊息對應。您可以宣告後續替代的訊息對應。

END_MSG_MAP 巨集將訊息對應的結束。請注意永遠只有 BEGIN_MSG_MAPEND_MSG_MAP一個執行個體。

如需使用的詳細資訊訊息在 ATL 對應,請參閱 訊息對應

範例

下列範例會顯示預設的訊息對應 (Message Map) 和一個替代的訊息對應,每個包含的處理函式:

BEGIN_MSG_MAP(CMyOneAltClass)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()

下面的範例會顯示兩個替代的訊息對應。預設的訊息對應是空的。

BEGIN_MSG_MAP(CMyClass)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
ALT_MSG_MAP(2)
   MESSAGE_HANDLER(WM_CREATE, OnCreate)
END_MSG_MAP()

需求

Header: atlwin.h

請參閱

參考

MESSAGE_HANDLER

CMessageMap 類別

CDynamicChain 類別

其他資源

訊息對應巨集 (ATL)

ATL 巨集