ON_MESSAGE

發行項
02/28/2013

指出哪一個函式會處理使用者自訂的訊息。

ON_MESSAGE(message, memberFxn)

參數

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

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

備註

使用者自訂的訊息會顯示任何訊息不是標準的 Windows WM_MESSAGE訊息。選取時的訊息識別碼，您必須使用的範圍內的數值WM_USER (0x0400) 為 0x7FFF 或WM_APP (0x8000) 到 0xBFFF。如需更多關於郵件識別碼的詳細資訊，請參閱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;
}