Partager via

Comment appeler un gestionnaire d’événements en Visual Basic

Un événement est une action ou une occurrence, comme un clic de souris ou une limite de crédit dépassée, qui est reconnue par un composant de programme et pour laquelle vous pouvez écrire du code pour répondre. Un gestionnaire d’événements est le code que vous écrivez pour répondre à un événement.

Un gestionnaire d’événements en Visual Basic est une Sub procédure. Cependant, vous ne l'appelez normalement pas de la même manière que les autres procédures Sub. Au lieu de cela, vous identifiez la procédure en tant que gestionnaire pour l’événement. Vous pouvez le faire avec une Handles clause et une WithEvents variable, ou avec une instruction AddHandler. L’utilisation d’une Handles clause est la méthode par défaut pour déclarer un gestionnaire d’événements en Visual Basic. Il s’agit de la façon dont les gestionnaires d’événements sont écrits par les concepteurs lorsque vous programmez dans l’environnement de développement intégré (IDE). L’instruction AddHandler convient pour déclencher des événements dynamiquement au moment de l’exécution.

Lorsque l’événement se produit, Visual Basic appelle automatiquement la procédure du gestionnaire d’événements. Tout code qui a accès à l’événement peut le provoquer en exécutant une instruction RaiseEvent.

Vous pouvez associer plusieurs gestionnaires d’événements au même événement. Dans certains cas, vous pouvez dissocier un gestionnaire d’un événement. Pour plus d’informations, consultez Événements.

Appeler un gestionnaire d’événements à l’aide Handles et WithEvents

  1. Vérifiez que l’événement est déclaré avec une instruction Event.

  2. Déclarez une variable d’objet au niveau du module ou de la classe à l’aide du WithEvents mot clé. La As clause de cette variable doit spécifier la classe qui déclenche l’événement.

  3. Dans la déclaration de la procédure de gestion Sub des événements, ajoutez une Handles clause qui spécifie la WithEvents variable et le nom de l’événement.

  4. Lorsque l’événement se produit, Visual Basic appelle automatiquement la Sub procédure. Votre code peut utiliser une RaiseEvent instruction pour effectuer l’événement.

    L’exemple suivant définit un événement et une WithEvents variable qui fait référence à la classe qui déclenche l’événement. La procédure de gestion des Sub événements utilise une Handles clause pour spécifier la classe et l’événement qu’elle gère.

    Public Class RaisesEvent
    Public Event SomethingHappened()
    Dim WithEvents happenObj As New RaisesEvent
    Public Sub ProcessHappen() Handles happenObj.SomethingHappened
        ' Insert code to handle somethingHappened event.
    End Sub
End Class

Appeler un gestionnaire d’événements à l’aide de AddHandler

  1. Vérifiez que l’événement est déclaré avec une Event déclaration.

  2. Exécutez une instruction AddHandler pour connecter dynamiquement la procédure de gestion des Sub événements à l’événement.

  3. Lorsque l’événement se produit, Visual Basic appelle automatiquement la Sub procédure. Votre code peut utiliser une RaiseEvent instruction pour effectuer l’événement.

    L’exemple suivant utilise l’instruction AddHandler dans le constructeur pour associer la OnFormClosing procédure en tant que gestionnaire d’événements pour FormClosing.

    Sub New()
    InitializeComponent()
    AddHandler Me.FormClosing, AddressOf OnFormClosing
End Sub

Private Sub OnFormClosing(sender As Object, e As FormClosingEventArgs)
    ' Insert code to deal with impending closure of this form.
End Sub

    Vous pouvez dissocier un gestionnaire d’événements d’un événement en exécutant l’instruction RemoveHandler.

Voir aussi