Visão geral dos manipuladores de eventos (Windows Forms)

Um manipulador de eventos é um método que está 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 manipular o evento corretamente. O exemplo a seguir mostra um manipulador de eventos para o evento Click do 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)  
  {  
  
  }  

O primeiro parâmetro,sender, fornece uma referência ao objeto que gerou o evento. O segundo parâmetro, e, no exemplo acima, passa um objeto específico para o evento que está sendo manipulado. Ao fazer referência às propriedades do objeto (e, às vezes, aos seus métodos), pode-se obter informações como a localização do rato para eventos de rato ou dados que estão a ser transferidos em eventos de arraste e largue.

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 seu 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 para controles diferentes. Por exemplo, se você tiver um grupo de controles RadioButton em um formulário, poderá criar um único manipulador de eventos para o evento Click e vincular o evento Click de cada controle ao manipulador de eventos único. Para obter mais informações, consulte Como conectar vários eventos a um único manipulador de eventos no Windows Forms.

Ver também

• Criando manipuladores de eventos no Windows Forms
• Visão geral dos eventos