Compartilhar via

Como chamar um manipulador de eventos no Visual Basic

Um evento é uma ação ou ocorrência , como um clique do mouse ou um limite de crédito excedido, que é reconhecido por algum componente do programa e para o qual você pode escrever código para responder. Um manipulador de eventos é o código que você escreve para responder a um evento.

Um manipulador de eventos no Visual Basic é um procedimento Sub. No entanto, você normalmente não chama isso da mesma maneira que outros procedimentos Sub. Em vez disso, você identifica o procedimento como um manipulador para o evento. Você pode fazer isso com uma cláusula Handles e uma variável WithEvents ou com uma Instrução AddHandler. Usar uma Handles cláusula é a maneira padrão de declarar um manipulador de eventos no Visual Basic. Essa é a maneira como os manipuladores de eventos são escritos pelos designers quando você programa no IDE (ambiente de desenvolvimento integrado). A instrução AddHandler é adequada para gerar eventos dinamicamente em tempo de execução.

Quando o evento ocorre, o Visual Basic chama automaticamente o procedimento do manipulador de eventos. Qualquer código que tenha acesso ao evento pode fazer com que ele ocorra executando uma Instrução RaiseEvent.

Você pode associar mais de um manipulador de eventos ao mesmo evento. Em alguns casos, você pode desassociar um manipulador de um evento. Para obter mais informações, consulte Eventos.

Chamar um manipulador de eventos usando Handles e WithEvents

  1. Verifique se o evento foi declarado com uma Instrução de Evento.

  2. Declare uma variável de objeto no nível do módulo ou da classe, usando a WithEvents palavra-chave. A As cláusula dessa variável deve especificar a classe que gera o evento.

  3. Na declaração do procedimento de tratamento Sub de eventos, adicione uma Handles cláusula que especifica a WithEvents variável e o nome do evento.

  4. Quando o evento ocorre, o Visual Basic chama automaticamente o Sub procedimento. Seu código pode usar uma RaiseEvent instrução para fazer o evento ocorrer.

    O exemplo a seguir define um evento e uma WithEvents variável que se refere à classe que gera o evento. O procedimento de manipulação Sub de eventos usa uma Handles cláusula para especificar a classe e o evento que ele manipula.

    Public Class RaisesEvent
    Public Event SomethingHappened()
    Dim WithEvents happenObj As New RaisesEvent
    Public Sub ProcessHappen() Handles happenObj.SomethingHappened
        ' Insert code to handle somethingHappened event.
    End Sub
End Class

Chamar um manipulador de eventos usando AddHandler

  1. Verifique se o evento foi declarado com uma instrução Event.

  2. Execute uma instrução AddHandler para conectar dinamicamente o procedimento de manipulação Sub de eventos com o evento.

  3. Quando o evento ocorre, o Visual Basic chama automaticamente o Sub procedimento. Seu código pode usar uma RaiseEvent instrução para fazer o evento ocorrer.

    O exemplo a seguir usa a instrução AddHandler no construtor para associar o OnFormClosing procedimento como um manipulador de eventos para FormClosing.

    Sub New()
    InitializeComponent()
    AddHandler Me.FormClosing, AddressOf OnFormClosing
End Sub

Private Sub OnFormClosing(sender As Object, e As FormClosingEventArgs)
    ' Insert code to deal with impending closure of this form.
End Sub

    Você pode desassociar um manipulador de eventos de um evento executando a instrução RemoveHandler.

Consulte também