Mapas do evento

Sempre que um controle de felicidade notificar seu contêiner alguma ação (determinada pelo desenvolvedor de controle) aconteceu (como um pressionamento de tecla, clique do mouse ou uma alteração de estado do controle), ele chama uma função de acionamento do evento.Essa função notifica o contêiner de controle que alguma ação importante ocorreu por disparo o evento relacionado.

A biblioteca Microsoft Foundation Class oferece um modelo de programação otimizado para eventos de acionamento.Nesse modelo, "evento mapas" usado para designar quais funções disparar os eventos para um determinado controle.Mapas de evento contém uma macro para cada evento.Por exemplo, um mapa de evento que dispara um estoque clique evento teria esta aparência:

BEGIN_EVENT_MAP(CMyAxCtrl, COleControl)
   EVENT_STOCK_CLICK()
END_EVENT_MAP()

O EVENT_STOCK_CLICK macro indica que o controle disparará um estoque clique evento sempre que detecta um mouse.Para obter uma lista mais detalhada de outros eventos de ações, consulte o artigo ActiveX controles: eventos.Macros também estão disponíveis para indicar eventos personalizados.

Embora as macros de mapa de evento são importantes, você geralmente não inseri-los diretamente.Isso ocorre porque a janela Propriedades cria automaticamente entradas de mapa de eventos nos arquivos de origem quando você usar para associar a eventos de funções de acionamento do evento.Sempre que você deseja editar ou adicionar uma entrada de mapa de evento, você pode usar a janela Propriedades.

Para dar suporte ao evento mapas, MFC fornece as seguintes macros:

Demarcação e declaração do mapa de eventos

DECLARE_EVENT_MAP

Declara que um mapa de evento será usado em uma classe para mapear os eventos para funções de acionamento do evento (deve ser usado na declaração da classe).

BEGIN_EVENT_MAP

Começa a definição de um mapa de eventos (deve ser usado na implementação de classe).

END_EVENT_MAP

Finaliza a definição de um mapa de eventos (deve ser usado na implementação de classe).

Macros de mapeamento de eventos

EVENT_CUSTOM

Indica qual função eventos-acionamento acionará o evento especificado.

EVENT_CUSTOM_ID

Indica qual função eventos-acionamento acionará o evento especificado, com uma identificação de expedição designado.

Macros de mapeamento de mensagem

ON_OLEVERB

Indica um verbo personalizado manipulado pelo controle OLE.

ON_STDOLEVERB

Substitui um mapeamento de verbo padrão do controle OLE.

Consulte também

Conceitos

Globais e Macros do MFC