Compartilhar via


Mapas de evento

Sempre que um controle deseja notificar seu contêiner que alguma ação (determinada pelo desenvolvedor do controle) aconteceu (sistema autônomo um pressionamento de tecla, clicar do mouse, ou uma alterar de estado do controle) chama uma função de acionamento do evento.Esta função notifica o contêiner de controle que alguma ação importante ocorreu, disparando o evento relacionado.

A biblioteca Microsoft Foundation classe oferece um modelo de programação otimizado para eventos de acionamento.Nesse modelo, "evento mapas" são usados para designar quais funções disparar os eventos para um determinado controle.Os mapas de evento contêm uma macro para cada evento.Por exemplo, um MAP de evento que aciona um estoque clicar evento teria esta aparência:

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

The EVENT_STOCK_CLICK macro indica que o controle disparará um estoque clicar evento cada time detecta um clicar do mouse.Para obter uma lista mais detalhada de outros eventos de ações, consulte o artigo Controles ActiveX: Eventos.As macros também estão disponível para indicar eventos personalizados.

Embora as macros do MAP de evento sejam importantes, você geralmente não insira-os diretamente.Isso ocorre porque a janela Propriedades cria automaticamente entradas de MAP de evento em seus arquivos de fonte quando você usá-lo para associar a eventos de acionamento do evento funções.Qualquer horário em que deseja edição ou adicionar uma entrada de MAP de evento, você pode usar a janela Propriedades.

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

Declaração de MAP de eventos e demarcação

DECLARE_EVENT_MAP

Declara que um MAP 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

Inicia a definição de um MAP de evento (deve ser usado na implementação de classe).

END_EVENT_MAP

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

Evento mapeamento macros

EVENT_CUSTOM

Indica qual função de acionamento do evento acionará o evento especificado.

EVENT_CUSTOM_ID

Indica qual função de acionamento do evento acionará o evento especificado com uma ID de expedição designado.

Macros de mapeamento de mensagem

ON_OLEVERB

Indica um verbo personalizado manipulado pelo controle OLE.

ON_STDOLEVERB

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

Consulte também

Conceitos

Macros do MFC e globais