ON_MESSAGE

Článek
06/10/2015

Označuje funkci, která bude zpracovávat zprávy definované uživatelem.

ON_MESSAGE(message, memberFxn)

Parametry

message
ID zprávy.
memberFxn
Název funkce obslužné rutiny zpráv, ke kterému je namapován zprávy.

Typ funkce musí být afx_msg LRESULT (CWnd::*)(WPARAM, LPARAM).

Poznámky

Uživatelem definované zprávy jsou všechny zprávy, které nejsou standardní Windows WM_MESSAGE zprávy.Při výběru ID zprávy, je nutné použít hodnoty v rozsahu od WM_USER (0x0400) na 0x7FFF nebo WM_APP (0x8000) na 0xBFFF.Další informace týkající se ID zprávy, viz WM_APP.

Je třeba přesně jeden ON_MESSAGE příkaz Makro v mapě zpráv pro všechny uživatelem definované zprávu, která musí být namapován na obslužnou rutinu zprávy.

[!POZNÁMKA]

Kromě zpráv definované uživatelem ON_MESSAGE zpracovává méně běžné zprávy systému Windows.Další informace naleznete v Knowledge Base v článku 99848: INFO: použití makro ON_MESSAGE() menší společné zprávy mapy.

Další informace a příklady naleznete v tématu zpracování zpráv a mapování témata aUživatelem definované obslužné rutiny

Příklad

#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;
}