Compartir a través de


AddHandler (Instrucción)

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

Vea también

Conceptos

Eventos y controladores de eventos

AddHandler y RemoveHandler

Referencia

RemoveHandler (Instrucción)

Handles

Event (Instrucción)