Adicionar um manipulador de eventos

No editor de recursos, você pode adicionar um novo manipulador de eventos ou editar um manipulador de eventos existente para um controle de caixa de diálogo usando o assistente de manipulador de eventos.

Você pode adicionar um evento à classe que implementa a caixa de diálogo usando a janela Propriedades. Para adicionar o evento a uma classe diferente da classe da caixa de diálogo, use o assistente do manipulador de eventos.

Para adicionar um manipulador de eventos a um controle de caixa de diálogo:

1. Clique duas vezes no recurso de caixa de diálogo no Modo de Exibição de Recursos para abrir o recurso de caixa de diálogo que contém o controle no editor de diálogo.

2. Clique com o botão direito do mouse no controle para o qual você deseja manipular o evento de notificação.

3. No menu de atalho, escolha Adicionar manipulador de eventos para exibir o Assistente do manipulador de eventos.

4. Selecione o evento na caixa Tipo de mensagem para adicionar à classe selecionada na caixa de listagem Classe .

5. Aceite o nome padrão na caixa Nome do manipulador de função ou forneça o nome de sua escolha.

6. Selecione Adicionar e editar para adicionar o manipulador de eventos ao projeto e abra o editor de texto na nova função para adicionar o código apropriado do manipulador de eventos.

   Se o tipo de mensagem selecionado já tiver um manipulador de eventos para a classe selecionada, Adicionar e editar não estará disponível e Editar código estará disponível. Selecione Editar código para abrir o editor de texto na função existente.

Como alternativa, você pode adicionar manipuladores de eventos na janela Propriedades. Para obter mais informações, consulte Adicionando manipuladores de eventos para controles de caixa de diálogo.

Nesta secção

• Assistente do manipulador de eventos

Assistente do manipulador de eventos

Este assistente adiciona um manipulador de eventos para um controle de caixa de diálogo à classe de sua escolha. Se você adicionar um manipulador de eventos da janela Propriedades, poderá adicioná-lo somente à classe que implementa a caixa de diálogo. Para obter mais informações, consulte Adicionando manipuladores de eventos para controles de caixa de diálogo.

• Nome do comando

  Identifica o controle selecionado, para o qual o manipulador de eventos é adicionado. Esta caixa não está disponível.

• Tipo de mensagem

  Exibe a lista de manipuladores de mensagens possíveis atuais para o controle selecionado.

• Nome do manipulador de função

  Exibe o nome da função adicionada para manipular o evento. O nome por padrão é baseado no tipo de mensagem e no comando, precedido por On. Por exemplo, para o botão chamado IDC_BUTTON1, o tipo de mensagem BN_CLICKED exibe o nome do manipulador de função OnBnClickedButton1.

• Lista de classes

  Exibe classes disponíveis às quais você pode adicionar um manipulador de eventos. A classe da caixa de diálogo selecionada é exibida em vermelho.

• Descrição do manipulador

  Fornece uma descrição para o item selecionado na caixa Tipo de mensagem . Esta caixa não está disponível.

• Adicionar e editar

  Adiciona o manipulador de mensagens à classe ou objeto selecionado. Ele também abre o editor de texto para a nova função para que você possa adicionar o código do manipulador para a notificação de controle.

• Editar código

  Abre o editor de texto para a função existente selecionada para que você possa adicionar ou editar o código do manipulador de notificação de controle.