ON_MESSAGE

Artigo
02/25/2013

Indica qual função manipulará uma mensagem definida pelo usuário.

ON_MESSAGE(message, memberFxn)

Parâmetros

message
A identificação da mensagem.
memberFxn
O nome da função de manipulador de mensagens para que a mensagem é mapeada.

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

Comentários

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

Deve haver exatamente um ON_MESSAGE instrução de macro em seu mapa da mensagem para cada mensagem definida pelo usuário que deve ser mapeado para uma função de manipulador de mensagens.

Observação
Além para mensagens definidas pelo usuário, ON_MESSAGE manipula mensagens menos comuns do Windows.Para obter mais informações, consulte o artigo 99848: INFO: Use ON_MESSAGE() Macro as mensagens menos comuns de mapa.

Para obter mais informações e exemplos, consulte manipulação de mensagens e tópicos de mapeamento de eManipuladores definida pelo 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;
}