ALT_MSG_MAP ( msgMapID )
Parâmetros
msgMapID
[no] O identificador de mapa de mensagem.
Observações
Marca o início de um mapa da mensagem alternativo. ATL identifica cada mapa da mensagem por um número. O mapa da mensagem padrão (declarado com a macro BEGIN_MSG_MAP ) é identificado por 0. Um mapa da mensagem alternativa é identificado por msgMapID.
Mapas de mensagem são usados para Processoar as mensagens enviadas para uma janela. Por exemplo, CContainedWindow permite que você especifique o identificador de um mapa da mensagem no objeto de recipiente. CContainedWindow:: WindowProc , em seguida, usa esse mapa da mensagem para direcionar mensagens da janela contido para a função de manipulador apropriado ou para outro mapa da mensagem. Para obter uma lista de macros que declare manipulador de funções, consulte BEGIN_MSG_MAP.
Sempre começa um mapa da mensagem com BEGIN_MSG_MAP. Em seguida, você pode declare mapas de mensagem alternativo subseqüentes. O exemplo a seguir mostra o mapa da mensagem padrão e o mapa da mensagem alternativo um, cada um contendo uma função de manipulador:
BEGI&N_MSG_MAP(CMyClass)
nbsp; MESSAGE_HANDLER (WM_PAINT, OnPaint)
ALT_MSG_MAP(1)
MESSAGE_HANDLER (WM_SETFOCUS, OnSetFocus)
END_MSG_MAP()
O próximo exemplo mostra dois mapas de mensagem alternativo. O mapa da mensagem padrão está vazio.
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()
A macro END_MSG_MAP marca o final do mapa da mensagem. Observe que sempre é exatamente uma instância de BEGIN_MSG_MAP e END_MSG_MAP.
Para obter mais informações sobre como usar mapas de mensagem no ATL, consulte Mensagem mapas no artigo "Classes de janela do ATL".
Ver também