Partilhar via


Visão geral dos Manipuladores de Eventos (Formulários do Windows)

Um manipulador de eventos é um método que é vinculado a um evento. Quando o evento é gerado, o código dentro do manipulador de eventos é executado. Cada manipulador de eventos fornece dois parâmetros que permitem que você manipule o evento corretamente. O exemplo a seguir mostra um manipulador de eventos para um evento Click de um controle Button.

Private Sub button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button1.Click

End Sub
private void button1_Click(object sender, System.EventArgs e) 
{

}
private void button1_Click(System.Object sender, System.EventArgs e) 
{

}
private:
  void button1_Click(System::Object ^ sender,
    System::EventArgs ^ e)
  {

  }

O primeiro parâmetro, sender, fornece uma referência ao objeto que gera o evento. O segundo parâmetro, e, no exemplo acima, passa um objeto específico para o evento que está sendo tratado. Ao fazer referência às propriedades do objeto (e algumas vezes, seus métodos), você pode obter informação como a posição do mouse para eventos do mouse, ou dados sendo transferidos em eventos de arrastar e soltar.

Normalmente, cada evento produz um manipulador de eventos com um tipo de objeto de evento diferente para o segundo parâmetro. Alguns manipuladores de eventos, como aqueles para os eventos MouseDown e MouseUp, têm o mesmo tipo de objeto para o segundo parâmetro. Para esses tipos de eventos, você pode usar o mesmo manipulador de eventos para manipular ambos os eventos.

Você também pode usar o mesmo manipulador de eventos para manipular o mesmo evento em controles diferentes. Por exemplo, se você tiver um grupo de controles RadioButton em um formulário, você pode criar um único manipulador de eventos para o evento Click e fazer com que todos os eventos Click do controle sejam vinculados a um único manipulador de eventos. Para obter mais informações, consulte Como: Conectar vários eventos a um único manipulador de eventos do Windows Forms.

Consulte também

Conceitos

Visão Geral dos Eventos (Formulários do Windows)

Outros recursos

Criando Manipuladores de Eventos nos Formulários do Windows