Handles, clause (Visual Basic)

Article
08/10/2011

Déclare qu'une procédure gère un événement spécifié.

proceduredeclaration Handles eventlist

Éléments

proceduredeclaration
Déclaration de procédure Sub de la procédure qui gérera l'événement.
eventlist
Liste des événements pour que proceduredeclaration gère, séparés par des virgules. Ces événements doivent être déclenchés par la classe de base de la classe en cours ou par un objet déclaré à l'aide du mot clé WithEvents.

Notes

Utilisez le mot clé Handles à la fin d'une déclaration de procédure pour que celle-ci gère les événements déclenchés par une variable objet déclarée à l'aide du mot clé WithEvents. Le mot clé Handles peut également être utilisé dans une classe dérivée pour gérer des événements à partir d'une classe de base.

La signature de la procédure doit correspondre aux signatures de chaque événement dans eventlist.

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. 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. L'instruction AddHandler connecte les procédures aux événements au moment de l'exécution. Pour plus d'informations, consultez AddHandler, instruction.

Pour les événements personnalisés, l'application appelle l'accesseur AddHandler de l'événement lors de l'ajout de la procédure comme gestionnaire d'événements. Pour plus d'informations sur les événements personnalisés, consultez Event, instruction.

Exemple

Public Class ContainerClass
    ' Module or class level declaration.
    WithEvents Obj As New Class1

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

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

    ' Call the TestEvents procedure from an instance of the ContainerClass 
    ' class to test the Ev_Event event and the event handler.
    Public Sub TestEvents()
        Obj.CauseSomeEvent()
    End Sub
End Class

L'exemple suivant montre comment une classe dérivée peut utiliser l'instruction Handles pour gérer un événement à partir d'une classe de base.

Public Class BaseClass
    ' Declare an event.
    Event Ev1()
End Class
Class DerivedClass
    Inherits BaseClass
    Sub TestEvents() Handles MyBase.Ev1
        ' Add code to handle this event.
    End Sub
End Class

L'exemple suivant contient deux gestionnaires d'événements de bouton pour un projet Application WPF.

L'exemple suivant équivaut au précédent : eventlist dans la clause Handles contient les événements pour les deux boutons.