Compartilhar via

Como lidar com um evento de controle

Os eventos para controles (e para formulários) geralmente são definidos por meio do Visual Studio Visual Designer para Windows Forms. A configuração de um evento por meio do Designer Visual é conhecida como manipulação de um evento em tempo de projeto. Você também pode lidar com eventos dinamicamente no código, conhecido como manipulação de eventos em runtime. Um evento criado no runtime permite que você conecte manipuladores de eventos dinamicamente com base no que seu aplicativo está fazendo no momento.

Manipular um evento em tempo de design

No Visual Studio, use o Visual Designer para gerenciar manipuladores para eventos de controle. O Designer Visual gerará o código do manipulador e o adicionará ao evento para você.

Definir o manipulador

Use o painel Propriedades para adicionar ou definir o manipulador de um evento:

  1. Abra o Designer Visual do formulário que contém o controle a ser modificado.

  2. Selecione o controle.

  3. Altere o modo de painel Propriedades para Eventos pressionando o botão de eventos ( ).

  4. Localize o evento ao qual você deseja adicionar um manipulador, por exemplo, o evento Clique :

    Painel de propriedades do Visual Studio mostrado com o modo de eventos habilitado e o evento de clique.

  5. Siga um destes procedimentos:

    • Clique duas vezes no evento para gerar um novo manipulador, ele estará em branco se nenhum manipulador for atribuído. Se não estiver em branco, essa ação abrirá o código do formulário e navegará até o manipulador existente.

    • Use a caixa de seleção ( ) para escolher um manipulador existente.

      A caixa de seleção listará todos os métodos que têm uma assinatura de método compatível para o manipulador de eventos.

Limpar o manipulador

Para remover um manipulador de eventos, você não pode simplesmente excluir o código do manipulador que está no arquivo code-behind do formulário, ele ainda é referenciado pelo designer. Use o painel Propriedades para remover o manipulador de um evento:

  1. Abra o Designer Visual do formulário que contém o controle a ser modificado.

  2. Selecione o controle.

  3. Altere o modo de painel Propriedades para Eventos pressionando o botão de eventos ( ).

  4. Localize o evento que contém o manipulador que você deseja remover, por exemplo, o evento Clique :

    Painel de propriedades do Visual Studio mostrado com o modo de eventos habilitado e o evento de clique.

  5. Clique com o botão direito do mouse no evento e escolha Redefinir.

Manipular um evento em runtime

Normalmente, você adiciona manipuladores de eventos aos controles na fase de design por meio do Designer Visual. No entanto, você pode criar controles em runtime, o que exige que você adicione manipuladores de eventos no código. Adicionar manipuladores no código também oferece a chance de adicionar vários manipuladores ao mesmo evento.

Adicionar um manipulador

O exemplo a seguir mostra como criar um controle e adicionar um manipulador de eventos. Esse controle é criado no Button.Click manipulador de eventos com um botão diferente. Quando Button1 é pressionado. O código move e dimensiona um novo botão. O evento do Click novo botão é tratado pelo MyNewButton_Click método. Para que o novo botão apareça, ele é adicionado à coleção do Controls formulário. Também há código para remover o Button1.Click manipulador do evento, que é discutido na seção Remover o manipulador .

private void button1_Click(object sender, EventArgs e)
{
    // Create and add the button
    Button myNewButton = new()
    {
        Location = new Point(10, 10),
        Size = new Size(120, 25),
        Text = "Do work"
    };

    // Handle the Click event for the new button
    myNewButton.Click += MyNewButton_Click;
    this.Controls.Add(myNewButton);

    // Remove this button handler so the user cannot do this twice
    button1.Click -= button1_Click;
}

private void MyNewButton_Click(object sender, EventArgs e)
{
    
}

Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
    'Create and add the button
    Dim myNewButton As New Button() With {.Location = New Point(10, 10),
                                          .Size = New Size(120, 25),
                                          .Text = "Do work"}

    'Handle the Click event for the new button
    AddHandler myNewButton.Click, AddressOf MyNewButton_Click
    Me.Controls.Add(myNewButton)

    'Remove this button handler so the user cannot do this twice
    RemoveHandler Button1.Click, AddressOf Button1_Click
End Sub

Private Sub MyNewButton_Click(sender As Object, e As EventArgs)

End Sub

Para executar esse código, faça o seguinte em um formulário usando o Visual Designer do Visual Studio:

  1. Adicione um novo botão ao formulário e nomeie-o como Button1.
  2. Altere o modo de painel Propriedades para Eventos pressionando o botão de evento ( ).
  3. Clique duas vezes no evento Clique para gerar um manipulador. Essa ação abre a janela de código e gera um método em branco Button1_Click .
  4. Substitua o código do método pelo código anterior acima.

Para obter mais informações sobre eventos em C#, consulte Eventos (C#) Para obter mais informações sobre eventos do Visual Basic, consulte Eventos (Visual Basic)

Remover o manipulador

A seção Adicionar um manipulador usou algum código para demonstrar a adição de um manipulador. Esse código também continha uma chamada para remover um manipulador:

button1.Click -= button1_Click;

RemoveHandler Button1.Click, AddressOf Button1_Click

Essa sintaxe pode ser usada para remover qualquer manipulador de eventos de qualquer evento.

Para obter mais informações sobre eventos em C#, consulte Eventos (C#) Para obter mais informações sobre eventos do Visual Basic, consulte Eventos (Visual Basic)

Como usar vários eventos com o mesmo manipulador

Com o painel Propriedades do Visual Studio Visual Designer, você pode selecionar o mesmo manipulador já em uso por um evento diferente. Siga as instruções na seção Definir o manipulador para selecionar um manipulador existente em vez de criar um novo.

Em C#, o manipulador é anexado ao evento de um controle no código do designer do formulário, que é modificado através do Designer Visual. Para obter mais informações sobre eventos em C#, consulte Eventos (C#)

Visual Basic

No Visual Basic, o manipulador é anexado ao evento de um controle no arquivo code-behind do formulário, em que o código do manipulador de eventos é declarado. Várias Handles palavras-chave podem ser adicionadas ao código do manipulador de eventos para usá-lo com vários eventos. O Designer Visual gerará a Handles palavra-chave para você e a adicionará ao manipulador de eventos. No entanto, você mesmo pode aplicar isso a qualquer evento e manipulador de eventos de um controle, desde que a assinatura do método do manipulador corresponda ao evento. Para obter mais informações sobre eventos do Visual Basic, consulte Eventos (Visual Basic)

Esse código demonstra como o mesmo método pode ser usado como um manipulador para dois eventos diferentes Button.Click :

Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click, Button2.Click
    'Do some work to handle the events
End Sub

Consulte também

  • Last updated on