Compartilhar via


Controles ActiveX MFC: eventos

Os controles ActiveX usam eventos para notificar um contêiner que algo ocorra ao controle. Os exemplos comuns de eventos incluem clique no controle, dados inseridos usando o teclado, e as alterações no estado do controle. Quando essas ações ocorrerem, o controle dispara um evento para alertar o contêiner.

Os eventos também são chamadas de mensagens.

MFC O oferece suporte a dois tipos de eventos: estoque e personalizados. Os eventos de estoque são os eventos que classificam as alças de COleControl automaticamente. Para obter uma lista completa dos eventos de estoque, consulte o artigo Controles ActiveX MFC: Para adicionar os eventos de estoque. Os eventos personalizados permitem a um controle a capacidade de notificar o contêiner quando um específico de ação ocorre ao controle. Alguns exemplos são uma alteração no estado interno de um controle ou de um recebimento de uma determinada mensagem da janela.

Para que o controle seja acionado eventos corretamente, a sua classe de controle deve mapear cada evento de controle para uma função de membro que deve ser chamada quando o evento relacionado ocorre. Esse mecanismo de mapeamento (chamado em um mapa de evento) é centralizada informações sobre o evento e permite que o Visual Studio facilmente acessar e manipular os eventos do controle. Esse mapa de evento é declarado pela macro, localizado em (cabeçalho. H) arquivo de declaração da classe de controle:

DECLARE_EVENT_MAP()

Depois que o mapa de evento foi declarado, deve ser definido no arquivo de implementação do controle .CPP (). As seguintes linhas de código definem o mapa de evento, permitindo que o controle seja acionado eventos específicos:

BEGIN_EVENT_MAP(CMyAxUICtrl, COleControl)


...


END_EVENT_MAP()

Se você usar o assistente de controle ActiveX de MFC para criar o projeto, o adiciona automaticamente essas linhas. Se você não usar o assistente de controle ActiveX de MFC, você deve adicionar essas linhas manualmente.

A exibição da classe, você pode adicionar os eventos de estoque suportados pela classe COleControl ou eventos personalizados que você definir. Para cada novo evento, a exibição da classe adiciona automaticamente a entrada apropriada para o mapa do evento de controle e arquivo de .IDL do controle.

Outros dois artigos a seguir discutem eventos em detalhes:

Consulte também

Referência

Classe COleControl

Conceitos

Controles ActiveX MFC

Controles ActiveX MFC: métodos