Compartir a través de


ON_MESSAGE

Indica qué función controlará un mensaje definido por el usuario.

ON_MESSAGE(message, memberFxn)

Parámetros

  • message
    Id. de mensaje.

  • memberFxn
    El nombre de la función de controlador de mensajes a la que está asignado el mensaje.

    El tipo de la función debe ser afx_msg LRESULT (CWnd::*)(WPARAM, LPARAM).

Comentarios

Los mensajes definidos por el usuario son cualquier mensaje que no sea mensajes estándar de Windows WM_MESSAGE .Al seleccionar un identificador de mensaje, debe utilizar valores dentro del intervalo de WM_USER (0x0400) a 0x7FFF o a WM_APP (0x8000) a 0xBFFF.Para obtener más información relacionada con el mensaje, vea WM_APP.

Debe haber exactamente una instrucción de macro de ON_MESSAGE en el mapa de mensajes para cada mensaje definido por el usuario que se asigne a una función de controlador de mensajes.

[!NOTA]

Además de mensajes definidos por el usuario, ON_MESSAGE controla menos mensajes comunes de Windows.Para obtener más información, vea el artículo de Knowledge Base 99848: INFO: Macro de uso ON_MESSAGE () para asignar mensajes de menos Común.

Para obtener más información y ejemplos, vea Temas del control de mensajes y de asignación y Controladores definido por el usuario

Ejemplo

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

Requisitos

Header: afxmsg_.h

Vea también

Referencia

ON_UPDATE_COMMAND_UI

ON_CONTROL

ON_REGISTERED_MESSAGE

ON_COMMAND

Conceptos

Macros y funciones globales de MFC