Partilhar via


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

Um manipulador de eventos é um método que está associado a um evento. Quando o evento é gerado, o código no 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 de Click um Button controle.

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)  
  {  
  
  }  

No primeiro parâmetro, sender, fornece uma referência ao objeto que gerou o evento. No exemplo acima, o segundo parâmetro, e, passa um objeto específico para o evento que está sendo manipulado. Consultando as propriedades do objeto (e, às vezes, seus métodos), é possível obter informações como o local do mouse para eventos de mouse ou dados que estão sendo transferidos em eventos do tipo "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 MouseDown de eventos 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 em controles diferentes. Por exemplo, se você tiver um grupo de controles em um formulário, poderá criar um único manipulador de eventos para o evento e ter o Click evento de cada controle vinculado ao manipulador de RadioButtonClick eventos único. Para obter mais informações, consulte Como conectar vários eventos a um único manipulador de eventos nos Windows Forms.

Confira também