CHAIN_MSG_MAP

CHAIN_MSG_MAP ( theChainClass )

Parâmetros

theChainClass

[no] O nome da classe base que contém o mapa de mensagem.

Observações

Define uma entrada em um mapa da mensagem. CHAIN_MSG_MAP direciona mensagens para Mapa da mensagem padrão da classe base (declarado com BEGIN_MSG_MAP). Para direcionar mensagens para Mapa da mensagem alternativo da classe base (declarado com ALT_MSG_MAP), use CHAIN_MSG_MAP_ALT.

Por exemplo:

classe CMyClass: CMyBaseClass públicos,...
{
público:
  ...

BEGI&N_MSG_MAP(CMyClass)
 nbsp;   MESSAGE_HANDLER (WM_PAINT, OnPaint)
     / / cadeia para Mapa da mensagem padrão em CMyBaseClass
     CHAIN_MSG_MAP(CMyBaseClass)
  ALT_MSG_MAP(1)
     / / cadeia para Mapa da mensagem padrão em CMyBaseClass
     CHAIN_MSG_MAP(CMyBaseClass)
  ALT_MSG_MAP(2)
     MESSAGE_HANDLER (WM_CHAR, OnChar)
     / / cadeia para Mapa da mensagem alternativo em CMyBaseClass
     CHAIN_MSG_MAP_ALT (CMyBaseClass, 1)
  END_MSG_MAP()

...
}

Este exemplo ilustra o seguinte:

• Se um procedimento janela está utilizando CMyClass do mapa da mensagem padrão e OnPaint faz não identificador uma mensagem, a mensagem é direcionada para CMyBaseClass do mapa da mensagem padrão para processamento.
  
  
• Se um procedimento janela está utilizando o primeiro mapa da mensagem alternativo em CMyClass , todas as mensagens são direcionadas para CMyBaseClass do mapa da mensagem padrão.
  
  
• Se um procedimento janela está utilizando CMyClass da segunda mensagem alternativo mapa e OnChar faz não identificador uma mensagem, a mensagem é direcionada para o mapa da mensagem alternativo especificado em CMyBaseClass . CMyBaseClass deve ter declarado esse mapa da mensagem comALT_MSG_MAP(1).

&Notanbsp;  Sempre começa um mapa da mensagem com BEGIN_MSG_MAP. Em seguida, você pode declare mapas de mensagem alternativa subseqüentes com ALT_MSG_MAP. A macro END_MSG_MAP marca o final do mapa da mensagem. Cada mapa da mensagem deve ter 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".

ATL Macros e funções Global

Ver também

CHAIN_MSG_MAP_MEMBER, CHAIN_MSG_MAP_DYNAMIC, MESSAGE_HANDLER