ALT_MSG_MAP ( msgMapID )
Parámetros
msgMapID
[en] El identificador del mapa de mensajes.
Observaciones
Marca el comienzo de un mapa de mensajes alternativos. ATL identifica cada mapa de mensajes por un número. El mapa de mensajes por defecto (declarado con la macro BEGIN_MSG_MAP ) ha sido identificado por 0. Un mapa de mensajes alternativos es identificado por msgMapID.
Mapas de mensajes se utilizan para procesar los mensajes enviados a una ventana. Por ejemplo, CContainedWindow permite especificar el identificador de un mapa de mensajes en el objeto que lo contiene. CContainedWindow::WindowProc , a continuación, utiliza este mapa de mensajes para dirigir mensajes de ventana contenida a la función de controlador apropiado o a otro mapa de mensajes. Para obtener una lista de macros que declarar funciones controladoras, consulte BEGIN_MSG_MAP.
Siempre empezar un mapa de mensajes con BEGIN_MSG_MAP. A continuación, puede declarar mapas de mensajes alternativos posteriores. En el ejemplo siguiente se muestra el mapa de mensaje predeterminado y un mensaje alternativo, cada uno con una función de controlador:
BEGI&N_MSG_MAP(CMyClass)
nbsp; MESSAGE_HANDLER (WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
MESSAGE_HANDLER (WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()
El ejemplo siguiente muestra dos mapas de mensajes alternativos. El mapa de mensajes por defecto está vacío.
BEGI&N_MSG_MAP(CMyClass)
ALT_MSG_MAP(1)
nbsp; MESSAGE_HANDLER (WM_PAINT, OnPaint)
MESSAGE_HANDLER (WM_SETFOCUS, OnSetFocus)
ALT_MSG_MAP(2)
MESSAGE_HANDLER (WM_CREATE, OnCreate)
END_MSG_MAP()
La macro END_MSG_MAP marca el final de la ruta de mensaje. Tenga en cuenta que siempre es exactamente una instancia de BEGIN_MSG_MAP y END_MSG_MAP.
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