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

Um manipulador de eventos é um método associado 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 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)  
  {  
  
  }  

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 tratado. Ao referenciar as propriedades do objeto (e, às vezes, seus métodos), você pode obter informações 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 os dos 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 lidar com 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 de RadioButton em um formulário, poderá criar um único manipulador de eventos para o evento Click e ter o evento Click de cada controle associado 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.

Consulte também

• criando manipuladores de eventos em do Windows Forms
• Visão geral de eventos