CHAIN_MSG_MAP

CHAIN_MSG_MAP ( theChainClass )

Parámetros

theChainClass

[en] El nombre de la clase base que contiene el mapa de mensajes.

Observaciones

Define una entrada en un mapa de mensajes. CHAIN_MSG_MAP dirige mensajes a mapa de mensajes de la clase base predeterminada (declarada con BEGIN_MSG_MAP). Para dirigir mensajes a mapa de mensajes alternativos de la clase base (declarada con ALT_MSG_MAP), utilice CHAIN_MSG_MAP_ALT.

Por ejemplo:

clase CMyClass: CMyBaseClass públicas,...
{
público:
  ...

BEGI&N_MSG_MAP(CMyClass)
 nbsp;   MESSAGE_HANDLER (WM_PAINT, OnPaint)
     / / cadena a mapa de mensaje predeterminado en CMyBaseClass
     CHAIN_MSG_MAP(CMyBaseClass)
  ALT_MSG_MAP(1)
     / / cadena a mapa de mensaje predeterminado en CMyBaseClass
     CHAIN_MSG_MAP(CMyBaseClass)
  ALT_MSG_MAP(2)
     MESSAGE_HANDLER (WM_CHAR, OnChar)
     / / cadena al mapa de mensajes alternativos en CMyBaseClass
     CHAIN_MSG_MAP_ALT (CMyBaseClass, 1)
  END_MSG_MAP()

...
}

Este ejemplo ilustra la siguiente:

• Si está utilizando un procedimiento de ventana CMyClass del mapa de mensaje predeterminado y OnPaint no asa un mensaje, el mensaje está dirigido a CMyBaseClass del mapa de mensajes de forma predeterminada para el procesamiento.
  
  
• Si utiliza el primer mapa de mensajes alternativos en un procedimiento de ventana CMyClass , todos los mensajes están dirigidos a CMyBaseClass del mapa de mensaje predeterminado.
  
  
• Si está utilizando un procedimiento de ventana CMyClass del segundo mensaje alternativo mapa y OnChar no asa un mensaje, el mensaje está dirigido al mapa mensaje alternativo especificado en CMyBaseClass . CMyBaseClass debe han declarado este mapa de mensajes conALT_MSG_MAP(1).

&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.

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

CHAIN_MSG_MAP_MEMBER, CHAIN_MSG_MAP_DYNAMIC, MESSAGE_HANDLER