Adicionar um manipulador de eventos

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

Adicione um evento à classe que implementa a caixa de diálogo usando a janela Propriedades. Para adicionar o evento a uma classe que não seja a classe de caixa de diálogo, use o assistente de 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 caixas de diálogo.

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

3. No menu de atalho, escolha Adicionar Manipulador de Eventos para exibir o Assistente de Manipulador de Eventos.

4. Selecione o evento na caixa Tipo de mensagem para adicionar à classe selecionada na caixa Lista de classes.

5. Aceite o nome padrão da caixa Nome do manipulador de funções 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 do manipulador de eventos apropriado.

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

Como alternativa, você pode adicionar manipuladores de eventos por meio da janela Propriedades. Para obter mais informações, confira Adicionando manipuladores de eventos a controles de caixa de diálogo.

Nesta seção

• Assistente de manipulador de eventos

Assistente de manipulador de eventos

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

• Nome do comando

  Identifica o controle selecionado, ao qual o manipulador de eventos é adicionado. Essa caixa não fica disponível.

• Tipo de mensagem

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

• Nome do manipulador de funções

  Exibe o nome da função adicionada para manipular o evento. Por padrão, o nome se baseia 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ções OnBnClickedButton1.

• Lista de classes

  Exibe as classes disponíveis às quais você pode adicionar um manipulador de eventos. A classe para a 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. Essa caixa não fica disponível.

• Adicionar e editar

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

• Editar código

  Abre o editor de texto na função selecionada, de modo que você possa adicionar ou editar o código do manipulador de notificações de controle.