My.Application.DoEvents, méthode

Mise à jour : novembre 2007

Traite tous les messages Windows qui sont actuellement contenus dans la file d'attente de messages.

' Usage
My.Application.DoEvents()
' Declaration
Public Sub DoEvents()

Notes

La méthode My.Application.DoEvents permet à votre application de gérer d'autres événements qui peuvent être déclenchés durant l'exécution de votre code. La méthode My.Application.DoEvents a le même comportement que la méthode DoEvents.

Lorsque vous exécutez une application Windows Forms, elle crée un nouveau formulaire qui attend ensuite les événements à gérer. Chaque fois que le formulaire gère un événement, par exemple un clic de bouton, il traite l'ensemble du code associé à cet événement. Tous les autres événements attendent dans la file d'attente. Lorsque votre code gère l'événement, votre application ne répond pas. Par exemple, la fenêtre ne se repeint pas si une autre fenêtre est glissée par-dessus.

Si vous appelez My.Application.DoEvents dans votre code, votre application peut gérer les autres événements. Par exemple, si votre code ajoute des données à ListBox dans une boucle, et s'il appelle My.Application.DoEvents après chaque étape de la boucle, votre formulaire se repeint lorsqu'une autre fenêtre est glissée par-dessus. Si vous supprimez My.Application.DoEvents de votre code, votre formulaire ne se repeint qu'à la fin de l'exécution du gestionnaire d'événements Click du bouton.

En général, vous utilisez cette méthode dans une boucle pour traiter des messages.

Remarque :
La méthode My.Application.DoEvents ne traite pas les événements exactement de la même manière que le formulaire. Utilisez le multithreading pour permettre au formulaire de gérer directement les événements. Pour plus d'informations, consultez Multithreading dans Visual Basic.

Attention :
Si une méthode qui gère un événement d'interface utilisateur appelle la méthode My.Application.DoEvents, celle-ci peut être entrée à nouveau avant de terminer. Cela peut se produire car la méthode My.Application.DoEvents traite des messages Windows, et ce type de message peut déclencher des événements.

Tâches

Le tableau suivant présente un exemple de tâche impliquant la méthode My.Application.DoEvents.

Exemple

Cet exemple utilise la méthode My.Application.DoEvents pour permettre la mise à jour de l'interface utilisateur de TextBox1.

Private Sub TestDoEvents()
    For i As Integer = 0 To 10000
        TextBox1.Text = i.ToString
        My.Application.DoEvents()
    Next
End Sub

Ce code doit être présent dans un formulaire qui contient un composant TextBox1 avec une propriété Text.

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :WindowsFormsApplicationBase

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Référence

My.Application, objet

WindowsFormsApplicationBase.DoEvents

DoEvents