ON_MESSAGE

發行項
06/10/2015

函式會處理使用者定義訊息的指示。

ON_MESSAGE(message, memberFxn)

參數

message
訊息 ID。
memberFxn
訊息對應訊息處理函式的名稱。

函式的型別必須是 afx_msg LRESULT (CWnd::*)(WPARAM, LPARAM)。

備註

使用者定義的訊息不是標準的 Windows WM_MESSAGE 訊息的所有訊息。如果選取訊息 ID 時，您必須在 WM_USER 內 (0x0400) 範圍的值到 0x7FFF 或 WM_APP (0x8000) 到 0xBFFF。如需訊息 ID 的詳細資訊，請參閱 WM_APP。

應完全與您的訊息對應的 ON_MESSAGE 巨集陳述式都必須對應到訊息處理函式的每個使用者定義的訊息。

注意事項
刪除使用者定義的訊息之外， ON_MESSAGE 處理較不常用的 Windows 訊息。如需詳細資訊，請 99848:詳細資訊:使用 ON_MESSAGE () 巨集對應少共用訊息參閱知識庫文件。

如需詳細資訊和範例，請參閱訊息處理和對應的主題和使用者定義的處理常式

範例

#define WM_MYMESSAGE (WM_USER + 100)

BEGIN_MESSAGE_MAP(CMyWnd2, CWnd)
   ON_MESSAGE(WM_MYMESSAGE, OnMyMessage)
END_MESSAGE_MAP()

// inside the class declaration
 afx_msg LRESULT OnMyMessage(WPARAM wParam, LPARAM lParam);

LRESULT CMyWnd2::OnMyMessage(WPARAM wParam, LPARAM lParam)
{
   UNREFERENCED_PARAMETER(wParam);
   UNREFERENCED_PARAMETER(lParam);

   // Handle message here. 

   return 0;
}