Compartilhar via

Visão geral de eventos

Um evento é uma ação à qual você pode responder ou "manipular", no código. Os eventos geralmente são gerados por uma ação do usuário, como clicar no mouse ou pressionar uma chave, mas também podem ser gerados pelo código do programa ou pelo sistema.

Aplicativos controlados por eventos executam código em resposta a um evento. Cada formulário e controle expõe um conjunto predefinido de eventos aos quais você pode responder. Se um desses eventos for gerado e houver um manipulador de eventos associado, o manipulador será invocado e o código será executado.

Os tipos de eventos gerados por um objeto variam, mas muitos tipos são comuns à maioria dos controles. Por exemplo, a maioria dos objetos tem um Click evento gerado quando um usuário clica nele.

Observação

Muitos eventos acontecem juntamente com outros eventos. Por exemplo, durante a ocorrência do evento DoubleClick, os eventos MouseDown, MouseUpe Click ocorrem.

Para obter informações gerais sobre como gerar e consumir um evento, consulte Manipulando e gerando eventos no .NET.

Delegados e sua função

Os delegados são classes comumente usadas no .NET para criar mecanismos de manipulação de eventos. Delegados equivalem aproximadamente a ponteiros de função, geralmente usados no Visual C++ e em outras linguagens orientadas a objetos. No entanto, diferente dos ponteiros de função, as classes delegate são orientadas a objeto, fortemente tipadas e seguras. Além disso, quando um ponteiro de função contém apenas uma referência a uma função específica, um delegado consiste em uma referência a um objeto e faz referência a um ou mais métodos dentro do objeto.

Esse modelo de evento usa delegados para associar eventos aos métodos que são usados ​​para lidar com eles. O delegado permite que outras classes se registrem para notificação de evento especificando um método de manipulador. Quando o evento ocorre, o delegado chama o método vinculado. Para obter mais informações sobre como definir delegados, consulte Manipulação e geração de eventos.

Os delegados podem ser associados a um único método ou a vários métodos, conhecidos como multicasting. Ao criar um delegado para um evento, você normalmente cria um evento multicast. Uma exceção rara pode ser um evento que resulta em um procedimento específico (como exibir uma caixa de diálogo) que não repetiria logicamente várias vezes por evento. Para obter informações sobre como criar um delegado multicast, consulte Como combinar delegados (Delegados Multicast).

Um delegado multicast mantém uma lista de invocação dos métodos aos quais está vinculado. O delegado multicast dá suporte a um método Combine para adicionar um método à lista de invocação e a um método Remove para removê-lo.

Quando um evento é registrado pelo aplicativo, o controle aciona o evento invocando o delegado para esse evento. A classe delegate chama o método vinculado. No caso mais comum (uma classe delegate multicast) a classe chama cada método associado da lista de invocação, que fornece uma notificação de um para muitos. Essa estratégia significa que o controle não precisa manter uma lista de objetos de destino para notificação de evento— o delegado manipula todo o registro e a notificação.

Essas classes também permitem que vários eventos sejam associados ao mesmo método, permitindo uma notificação muitos para um. Por exemplo, um evento de clique no botão e um evento de clique em comando de menu podem invocar o mesmo delegado, que então chama um único método para lidar com esses eventos separados da mesma maneira.

O mecanismo de associação usado com delegados é dinâmico: um delegado pode ser associado em tempo de execução a qualquer método cuja assinatura corresponda à do manipulador de eventos. Com esse recurso, você pode configurar ou alterar o método associado dependendo de uma condição e anexar dinamicamente um manipulador de eventos a um controle.

Eventos no Windows Forms

Os eventos em Windows Forms são declarados com o EventHandler<TEventArgs> delegado para métodos manipuladores. Cada manipulador de eventos fornece dois parâmetros que permitem manipular o evento corretamente. O exemplo a seguir mostra um manipulador de eventos para um Button controle do evento Click.

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

}

O primeiro parâmetrosender fornece uma referência ao objeto que gerou o evento. O segundo parâmetro, e, passa um objeto específico para o evento que está sendo gerenciado. 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 que estão sendo transferidos em eventos de arraste e solte.

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 o MouseDown e MouseUp eventos, 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 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 RadioButton controles em um formulário, poderá criar um único manipulador de eventos para o Click evento de cada RadioButton. Para obter mais informações, consulte Como lidar com um evento de controle.

Conteúdo relacionado