ON_MESSAGE

Artigo
06/10/2015

Indica que função tratará uma mensagem definida pelo usuário.

ON_MESSAGE(message, memberFxn)

Parâmetros

message
A ID de mensagem
memberFxn
O nome da função retornadas à qual a mensagem é mapeada.

O tipo de função deve ser afx_msg LRESULT (CWnd::*)(WPARAM, LPARAM).

Comentários

Mensagens definidas pelo usuário são todas as mensagens que não são mensagens padrão de WM_MESSAGE do windows. Ao selecionar um ID de mensagem, você deve usar valores dentro do intervalo de WM_USER () 0x0400 a 0x7FFF ou a WM_APP (0x8000) a 0xBFFF. Para obter mais informações sobre as IDs de mensagem, consulte WM_APP.

Deve haver exatamente uma instrução macro de ON_MESSAGE em seu mapa de mensagem para cada mensagem definida pelo usuário que deve ser mapeada para uma função retornadas a.

Dica

Além das mensagens definidas pelo usuário, ON_MESSAGE trata mensagens menos comum do windows.Artigo da Base de Dados de Conhecimento Para 99848: INFORMAÇÕES: Use a macro de ON_MESSAGE () para mapear mensagens de menos comumobter mais informações, consulte.

Para obter mais informações e exemplos, consulte Tópicos de manipulação e o mapeamento de mensagem e Manipuladores definidos do usuário

Exemplo

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