Fazendo o seu programa reagir ao usuário: Criando um manipulador de eventos

Artigo
08/25/2010

Nesta lição, você aprenderá a criar um manipulador de eventos.

Como você viu em lições anteriores, os controles têm propriedades, métodos e eventos e são usados para criar a interface do usuário.Eventos são coisas interessantes que podem acontecer em um controle.Por exemplo, um controle pode ser clicado, texto pode ser digitado nele, o ponteiro do mouse pode passar por ele e assim por diante.

Quando algo interessante ocorre, o controle dispara um evento.Isso significa que ele envia um sinal para o programa para permitir que ele saiba que algo ocorreu.O programa, em seguida, verifica se ele possui os métodos para manipular esse evento.Esses métodos são chamados manipuladores de eventos.Um exemplo é um método que é executado quando um botão é clicado, como o método que você criou em Interação com o usuário: Usando botões.

Os controles podem disparar vários tipos de eventos, mas há sempre um evento padrão para cada controle.Você pode criar manipuladores de eventos para uma variedade de eventos de controle.Nesta lição, você criará manipuladores de eventos para manipular um manipulador de evento padrão de um botão, o evento Click.Este é o evento que ocorre quando você clica no botão.Em seguida, você criará manipuladores de eventos para manipular os eventos MouseEnter e MouseLeave do botão.Esses são os eventos que ocorrem quando o mouse se move por um controle.

Tente-o!

Para manipular o evento Click

On the Arquivo menu, clicar Novo projeto.
Na caixa de diálogo Novo Projeto , no painel de Templates, clique em Windows Application .
Na caixa Name, digite EventHandler e clique em OK.

Abre um novo projeto Windows Forms.
Na Caixa de Ferramentas, arraste um controle Button para o formulário.
No Propriedades janela, defina o AutoSize propriedade para True.
No menu View, clique em Code para abrir o Editor de Código.

Logo acima do Editor de Código, observe as duas caixas suspensas.A caixa na esquerda contém uma lista de todos os controles no formulário, além do Form1, (General) e (Form1 Events).A caixa no lado direito lista cada evento disponível para o item listado na caixa à esquerda.
Na caixa no lado esquerdo, clique em Button1.
Na caixa no lado direito, clique em Click.

Um novo manipulador de eventos chamado Button1_Click aparece no Editor de Códigos.

Observação:

Você pode inserir o manipulador de eventos padrão para um controle clicando duas vezes no controle no formulário.
No manipulador de eventos Button1_Click, digite o código a seguir.
```
MsgBox("You clicked the button")
```
Pressione F5 para executar o aplicativo.Quando você clica em Button1, aparece um caixa de mensagem.

Observação:
Você pode inserir o manipulador de eventos padrão para um controle clicando duas vezes no controle no formulário.

Adicionando outros manipuladores de eventos

Você pode escrever código em manipuladores de eventos adicionais para o mesmo controle.Por exemplo, você pode alterar o texto que aparece no botão quando um usuário move o ponteiro do mouse sobre o botão.

Para manipular o evento MouseEnter

No Editor de Códigos, certifique-se que Button1 está selecionado na caixa suspensa no lado esquerdo e em seguida, clique em MouseEnter na caixa suspensa no lado direito.

Um novo manipulador de eventos chamado Button1_MouseEnter aparece no Editor de Códigos.
No manipulador de eventos Button1_MouseEnter, digite o código a seguir.
```
Button1.Text = "The Mouse has entered"
```
Pressione F5 para executar o aplicativo.Passe o ponteiro do mouse sobre o botão.Observe que quando o ponteiro do mouse passa pelo Button1, o texto no botão é alterado.

Talvez você tenha percebido no exemplo anterior que embora o texto de Button1 mude quando o ponteiro do mouse passa sobre ele, o texto não volta ao normal quando o ponteiro do mouse sai.Se você desejar que o texto mude quando o mouse não estiver mais sobre o botão, você deve manipular o evento MouseLeave e também o evento MouseEnter.

Para manipular o evento MouseLeave

No Editor de Códigos, certifique-se que Button1 está selecionado na caixa suspensa no lado esquerdo e em seguida, clique em MouseLeave na caixa suspensa no lado direito.

Um novo manipulador de eventos chamado Button1_MouseLeave aparece no Editor de Códigos.
No manipulador de eventos Button1_MouseLeave, digite o código a seguir.
```
Button1.Text = "The mouse has left"
```
Pressione F5 para executar o aplicativo.

Agora, quando o ponteiro do mouse passa sobre o botão, o texto é alterado para The mouse has entered, mas quando o mouse não estiver mais sobre o botão, o texto é alterado para The mouse has left.

Próximas etapas

Nesta lição, você aprendeu como criar um manipulador de eventos usando o Editor de código.Neste ponto, você pode ir para a próxima lição na sequência, Ao obter usuário opções: Usando caixas de seleção e botões de opção, ou examinar os manipuladores de eventos com Examinar mais detalhadamente: Compartilhamento de um manipulador evento.Se você escolher a segunda opção, você deve salvar o projeto EventHandler para uso na lição.