ALT_MSG_MAP

Marca el principio de un mapa de mensajes alternativo.

ALT_MSG_MAP( msgMapID )

Parámetros

  • msgMapID
    [in] El identificador del mapa de mensajes.

Comentarios

ATL identifica cada mapa de mensajes por un número.El mapa de mensajes predeterminado (declarado con la macro de BEGIN_MSG_MAP ) se identifica por 0.Un mapa de mensajes alternativo se identifica mediante msgMapID.

Los 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 contenedor.CContainedWindow::WindowProc utilice este mapa de mensajes para enviar los mensajes de la ventana contenida a la función adecuada de controlador u otro mapa de mensajes.Para obtener una lista de macros que declare funciones de controlador, vea BEGIN_MSG_MAP.

Siempre se inicia un mapa de mensajes con BEGIN_MSG_MAP.Puede declarar entonces asigna alternativos subsiguientes del mensaje.

La macro de END_MSG_MAP marca el final del mapa de mensajes.Observe que siempre hay exactamente una instancia de BEGIN_MSG_MAP y de END_MSG_MAP.

Para obtener más información sobre cómo utilizar mapas de mensajes en ATL, vea Mapas de mensajes.

Ejemplo

El ejemplo siguiente se muestra el mapa predeterminado y un mapa de mensajes alternativo, cada una función de mensaje de controlador que contiene:

BEGIN_MSG_MAP(CMyOneAltClass)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()

El ejemplo siguiente muestra dos mapas alternativos de mensajes.El mapa de mensajes predeterminado está vacío.

BEGIN_MSG_MAP(CMyClass)
ALT_MSG_MAP(1)
   MESSAGE_HANDLER(WM_PAINT, OnPaint)
   MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
ALT_MSG_MAP(2)
   MESSAGE_HANDLER(WM_CREATE, OnCreate)
END_MSG_MAP()

Requisitos

encabezado: atlwin.h

Vea también

Referencia

MESSAGE_HANDLER

Clase de CMessageMap

Clase de CDynamicChain

Otros recursos

Macros de mapa de mensajes (ATL)

Macros de ATL