AddHandler (Instrucción)

Artículo
10/07/2008

Actualización: noviembre 2007

Asocia un evento a un controlador de eventos en tiempo de ejecución.

AddHandler event, AddressOf eventhandler

Partes

event
Nombre del evento que se va a controlar.
eventhandler
Nombre del procedimiento que controlará el evento.

Comentarios

Las instrucciones AddHandler y RemoveHandler permiten iniciar y detener el controlador del evento en cualquier momento de la ejecución del programa.

La firma del procedimiento eventhandler debe coincidir con la firma del evento event.

La palabra clave Handles y la instrucción AddHandler permiten especificar que ciertos procedimientos controlen eventos determinados, pero hay diferencias entre ambos. La instrucción AddHandler conecta los procedimientos a los eventos en tiempo de ejecución. Utilice la palabra clave Handles al definir un procedimiento para especificar que controla un evento determinado. Para obtener más información, vea Handles.

En los eventos personalizados, la instrucción AddHandler invoca al descriptor de acceso AddHandler del evento. Para obtener más información sobre eventos personalizados, vea Event (Instrucción).

Ejemplo

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