Vue d'ensemble du contrôle ProgressBar (Windows Forms)
Important
Le contrôle ToolStripProgressBar remplace le contrôle ProgressBar et lui ajoute des fonctionnalités ; toutefois, le contrôle ProgressBar est conservé pour la compatibilité descendante et l'utilisation future si tel est votre choix.
Le contrôle ProgressBar Windows Forms indique l'état d'avancement d'un processus par l'affichage d'un nombre approprié de rectangles disposés dans une barre horizontale. Lorsque le processus est terminé, la barre est entièrement remplie. Les barres de progression sont couramment utilisées pour indiquer à l'utilisateur le temps qu'il doit encore attendre avant qu'un processus ne se termine, par exemple dans le cas du chargement d'un fichier volumineux.
Notes
Le contrôle ProgressBar peut uniquement être orienté horizontalement sur le formulaire.
Propriétés et méthodes principales
Les principales propriétés du contrôle ProgressBar sont Value, Minimum et Maximum. Les propriétés Minimum et Maximum définissent les valeurs maximale et minimale que la barre de progression peut afficher. La propriété Value représente la progression de l'opération. Dans la mesure où la barre affichée dans le contrôle est constituée de blocs, la valeur affichée par le contrôle ProgressBar n'est qu'une approximation de la valeur actuelle de la propriété Value. En fonction de la taille du contrôle ProgressBar, la propriété Value détermine à quel moment afficher le bloc suivant.
Le moyen le plus courant de mettre à jour la valeur de progression actuelle consiste à écrire du code pour définir la propriété Value. Dans l'exemple du chargement d'un gros fichier, la valeur maximale définie peut correspondre à la taille en kilo-octets du fichier. Par exemple, si la propriété Maximum a la valeur 100, la propriété Minimum a la valeur 10 et la propriété Value a la valeur 50, 5 rectangles seront affichés. C'est la moitié du nombre qui peut être affiché.
Cependant, il existe d'autres moyens de modifier la valeur affichée par le contrôle ProgressBar, outre la définition directe de la propriété Value. La propriété Step peut être utilisée pour spécifier une valeur d'incrémentation de la propriété Value. Ensuite, l'appel à la méthode PerformStep incrémente la valeur. Pour varier la valeur de l'incrément, vous pouvez utiliser la méthode Increment et préciser une valeur d'incrémentation de la propriété Value.
StatusBar est un autre contrôle graphique qui informe l'utilisateur sur l'état d'avancement de l'action en cours.
Important
Les contrôles StatusStrip et ToolStripStatusLabel remplacent les contrôles StatusBar et StatusBarPanel et y ajoutent des fonctionnalités ; toutefois, les contrôles StatusBar et StatusBarPanel sont conservés pour la compatibilité descendante et une utilisation future, si tel est votre choix.