Handles, clause (Visual Basic)

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

Syntaxe

proceduredeclaration Handles eventlist

Éléments

proceduredeclaration Déclaration Sub de procédure de la procédure qui gère l’événement.

eventlist Liste des événements à proceduredeclaration gérer, séparés par des virgules. Les événements doivent être déclenchés par la classe de base pour la classe en cours ou par un objet déclaré à l'aide du mot clé WithEvents.

Remarques

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.

Le mot clé Handles et l'instruction AddHandler vous 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 quand vous définissez une procédure pour indiquer qu'elle 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 quand elle ajoute la procédure comme gestionnaire d’événements. Pour plus d’informations sur les événements personnalisés, consultez l’instruction d’événement.

Exemple 1

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

Exemple 2

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

Private Sub Button1_Click(sender As System.Object, e As System.Windows.RoutedEventArgs) Handles Button1.Click
    MessageBox.Show(sender.Name & " clicked")
End Sub

Private Sub Button2_Click(sender As System.Object, e As System.Windows.RoutedEventArgs) Handles Button2.Click
    MessageBox.Show(sender.Name & " clicked")
End Sub

Exemple 3

L'exemple suivant est équivalent à l'exemple précédent. La liste eventlist dans la clause Handles contient les événements pour les deux boutons.

Private Sub Button_Click(sender As System.Object, e As System.Windows.RoutedEventArgs) Handles Button1.Click, Button2.Click
    MessageBox.Show(sender.Name & " clicked")
End Sub

Voir aussi