MESSAGE_HANDLER ( msg, func )
Parámetros
msg
[en] El mensaje de Windows.
func
[en] El nombre de la función de controlador de mensajes.
Observaciones
Define una entrada en un mapa de mensajes. MESSAGE_HANDLER mapas de un mensaje de Windows a la función de controlador especificado. Por ejemplo:
clase CMyClass:...
{
público:
nbsp; ...
BEGI&N_MSG_MAP(CMyClass)
MESSAGE_HANDLER (WM_PAINT, OnPaint)
...
END_MSG_MAP()
/ / Cuando un objeto CMyClass recibe un WM_PAINT
/ / mensaje, el mensaje está dirigido a
/ / CMyClass::OnPaint para el procesamiento.
LRESULT OnPaint (...)
{ ... }
}
Cualquier función especificada en una macro MESSAGE_HANDLER debe definir como sigue:
LRESULT MessageHandler(UINT uMsg, WP&ARAM wParam, LPARAM lParam, BOOLamp; bHandled)
El mensaje mapa establece bHandled en TRUE antes de MessageHandler se llama. Si MessageHandler no controla plenamente el mensaje, debe establecer bHandled en FALSE para indicar el mensaje necesita más procesamiento.
&Notanbsp; Siempre empezar un mapa de mensajes con BEGIN_MSG_MAP. A continuación, puede declarar posterior mensaje alterno mapas con ALT_MSG_MAP. La macro END_MSG_MAP marca el final de la ruta de mensaje. Cada mapa de mensajes debe tener exactamente una instancia de BEGIN_MSG_MAP y END_MSG_MAP.
Además de MESSAGE_HANDLER, puede utilizar COMMAND_HANDLER y NOTIFY_HANDLER para asignar WM_COMMAND y mensajes WM_NOTIFY , respectivamente.
Para obtener más información acerca del uso de mapas de mensajes en ATL, vea Mapas de mensaje en el artículo "Clases de ventana ATL".
ATL Macros y funciones globales
Véase también