AddHandler, instruction

Article
09/12/2008

Mise à jour : novembre 2007

Associe un événement à un gestionnaire d'événements au moment de l'exécution.

AddHandler event, AddressOf eventhandler

Éléments

event
Nom de l'événement à gérer.
eventhandler
Nom de la procédure qui gère l'événement.

Notes

Les instructions AddHandler et RemoveHandler vous permettent de débuter et d'arrêter la gestion d'un événement à tout moment au cours de l'exécution du programme.

La signature de la procédure eventhandler doit correspondre à celle de l'événement event.

Le mot clé Handles et l'instruction AddHandler permettent de spécifier que des procédures particulières gèrent des événements particuliers, mais il existe des différences. L'instruction AddHandler connecte les procédures aux événements au moment de l'exécution. Utilisez le mot clé Handles lors de la définition d'une procédure pour spécifier qu'il gère un événement particulier. Pour plus d'informations, consultez Handles.

Pour les événements personnalisés, l'instruction AddHandler appelle l'accesseur AddHandler de l'événement. Pour plus d'informations sur les événements personnalisés, consultez Event, instruction.

Exemple

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