WindowsFormsApplicationBase.DoEvents Méthode

Définition

Traite tous les messages Windows présents dans la file d'attente de messages.

public:
 void DoEvents();
public void DoEvents ();
member this.DoEvents : unit -> unit
Public Sub DoEvents ()

Exemples

Cet exemple utilise la My.Application.DoEvents méthode pour autoriser la mise à jour de l’interface utilisateur pour 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 dans un formulaire qui a un TextBox1 composant avec une Text propriété.

Remarques

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

Lorsque vous exécutez une application Windows Forms, elle crée un nouveau formulaire, qui attend ensuite que les événements soient gérés. Chaque fois que le formulaire gère un événement, tel qu’un clic sur un bouton, il traite tout le code associé à cet événement. Tous les autres événements attendent dans la file d’attente. Bien que votre code gère l’événement, votre application ne répond pas. Par exemple, la fenêtre ne repeint pas si une autre fenêtre est déplacée sur le dessus.

Si vous appelez My.Application.DoEvents votre code, votre application peut gérer les autres événements. Par exemple, si votre code ajoute des données à un ListBox dans une boucle, et après chaque étape de la boucle qu’il appelle My.Application.DoEvents, votre formulaire repeint lorsqu’une autre fenêtre est déplacée sur elle. Si vous supprimez My.Application.DoEvents de votre code, votre formulaire ne sera pas repeint tant que le gestionnaire d’événements click du bouton n’est pas terminé.

En règle générale, vous utilisez cette méthode dans une boucle pour traiter les messages.

Notes

La méthode My.Application.DoEvents ne traite pas exactement les événements de la même façon que le formulaire. Utilisez le multithreading pour que le formulaire gère directement les événements. Pour plus d’informations, consultez Utilisation de threads et de threading.

Attention

Si une méthode qui gère un événement d’interface utilisateur appelle la My.Application.DoEvents méthode, la méthode peut être réinscrite avant sa fin. Cela peut se produire, car la méthode traite les My.Application.DoEvents messages Windows et les messages Windows peuvent déclencher des événements.

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

À Consultez
Autoriser un formulaire à répondre à l’entrée de l’interface utilisateur lorsqu’il est occupé Procédure pas à pas : gestion des événements

Disponibilité par type de projet

Type de projet Disponible
Application Windows Forms Oui
Bibliothèque de classes Non
Application console Non
Bibliothèque de contrôles Windows Forms Non
Bibliothèque de contrôles web Non
Service Windows Non
Site web Non

S’applique à

Voir aussi