ALT_MSG_MAP
Marca o início de um mapa alternativo de mensagem.
ALT_MSG_MAP( msgMapID )
Parâmetros
- msgMapID
[in] o identificador do mapa de mensagem.
Comentários
ATL identifica cada mapa de mensagens por um número.O mapeamento padrão de mensagens (declarada com a macro de BEGIN_MSG_MAP ) é identificado por 0.Um mapa alternativo de mensagem é identificado por msgMapID.
Mapas de mensagem são usados para processar as mensagens enviadas a uma janela.Por exemplo, CContainedWindow permite que você especifique o identificador de um mapa de mensagem no objeto contêiner.CContainedWindow::WindowProc usar este mapa de mensagem para direcionar as mensagens de janela contida a função apropriada do manipulador ou a outro mapa de mensagem.Para obter uma lista de macros que declarar funções do manipulador, consulte BEGIN_MSG_MAP.
Inicie sempre um mapa de mensagem com BEGIN_MSG_MAP.Você pode declarar em mapas alternativos subseqüentes de mensagem.
A macro de END_MSG_MAP marca ao final do mapa de mensagem.Observe que há sempre exatamente uma instância de BEGIN_MSG_MAP e de END_MSG_MAP.
Para obter mais informações sobre como usar mapas de mensagem em ATL, consulte Mapas de mensagem.
Exemplo
O exemplo a seguir mostra o mapeamento padrão de mensagem e um mapa alternativo de mensagem, cada uma função de manipulador:
BEGIN_MSG_MAP(CMyOneAltClass)
MESSAGE_HANDLER(WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
MESSAGE_HANDLER(WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()
O exemplo a seguir mostra dois mapas alternativas de mensagem.O mapeamento padrão de mensagem está vazia.
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
Cabeçalho: atlwin.h