Compartilhar via


Instrução AddHandler

Associa um evento com um manipulador de eventos em tempo de execução.

AddHandler event, AddressOf eventhandler

Partes

  • event
    O nome do evento para manipular.

  • eventhandler
    O nome de um procedimento que manipula o evento.

Comentários

O AddHandler e RemoveHandler instruções permitem iniciar e parar manipulação de eventos a qualquer momento durante a execução do programa.

A assinatura da eventhandler procedimento deve corresponder à assinatura do evento event.

A palavra-chave Handles e a instrução AddHandler ambas permitem que você especifique que determinados procedimentos manipulem eventos específicos, mas há diferenças. A instrução AddHandler conecta os procedimentos a eventos em tempo de execução. Use a palavra-chave Handles ao definir um procedimento para especificar que ele manipula um evento específico. Para obter mais informações, consulte Cláusula Handles (Visual Basic).

Dica

Para eventos personalizados, a instrução AddHandler chama o evento do acessador AddHandler.Para obter mais informações sobre eventos personalizados, consulte Instrução Event.

Exemplo

Sub TestEvents()
    Dim Obj As New Class1
    ' Associate an event handler with an event. 
    AddHandler Obj.Ev_Event, AddressOf EventHandler
    ' Call the method to raise the event.
    Obj.CauseSomeEvent()
    ' Stop handling events. 
    RemoveHandler Obj.Ev_Event, AddressOf EventHandler
    ' This event will not be handled.
    Obj.CauseSomeEvent()
End Sub 

Sub EventHandler()
    ' Handle the event.
    MsgBox("EventHandler caught event.")
End Sub 

Public Class Class1
    ' Declare an event. 
    Public Event Ev_Event()
    Sub CauseSomeEvent()
        ' Raise an event. 
        RaiseEvent Ev_Event()
    End Sub 
End Class

Consulte também

Referência

Instrução RemoveHandler

Cláusula Handles (Visual Basic)

Instrução Event

Outros recursos

Eventos (Visual Basic)