ALT_MSG_MAP

Artigo
08/25/2010

Marca o início de um MAP da mensagem alternativo.

ALT_MSG_MAP( msgMapID )

Parâmetros

msgMapID
[in] O identificador de MAP da mensagem.

Comentários

ATL identifica cada MAP da mensagem por um número.O MAP da mensagem padrão (declarado com o BEGIN_MSG_MAP macro) é identificada por 0. Um MAP da mensagem alternativa é identificado por msgMapID.

Mensagem de mapas é usadas para processar as mensagens enviadas para uma janela.Por exemplo, CContainedWindow permite que você especifique o identificador de um MAP da mensagem no objeto de recipiente.CContainedWindow::WindowProc usa esse MAP da mensagem para direcionar mensagens da janela contidos para a função de manipulador apropriado ou para outro MAP da mensagem.Para obter uma lista de macros declarar o manipulador de funções, consulte BEGIN_MSG_MAP.

Sempre começam com um MAP da mensagemBEGIN_MSG_MAP. Em seguida, você pode declarar mapas de mensagem subseqüente alternativo.

The END_MSG_MAP macro marca o participante do MAP da mensagem.Observe que sempre há exatamente uma instância de BEGIN_MSG_MAP e END_MSG_MAP.

Para obter mais informações sobre o uso de mapas de mensagem em ATL, consulte Mapas de mensagem.

Exemplo

O exemplo a seguir mostra o MAP da mensagem padrão e o MAP da mensagem alternativo um, cada um contendo 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 de mensagem alternativo.O MAP da mensagem padrão está vazio.

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()