Partager via

Vue d'ensemble du contrôle ProgressBar (Windows Forms)

  • Article

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 Windows Forms ProgressBar indique la progression d’un processus en affichant un nombre approprié de rectangles organisés dans une barre horizontale. Une fois le processus terminé, la barre est remplie. Les barres de progression sont couramment utilisées pour donner à l’utilisateur une idée de la durée d’attente d’un processus à effectuer ; par exemple, lorsqu’un fichier volumineux est chargé.

Remarque

Le ProgressBar contrôle ne peut être orienté horizontalement que sur le formulaire.

Propriétés et méthodes clés

Les propriétés clés du ProgressBar contrôle sont Value, Minimumet Maximum. Les Minimum propriétés et Maximum les propriétés définissent les valeurs maximales et minimales que la barre de progression peut afficher. La Value propriété représente la progression qui a été effectuée pour terminer l’opération. Étant donné que la barre affichée dans le contrôle est composée de blocs, la valeur affichée par le ProgressBar contrôle correspond uniquement à la valeur actuelle de la Value propriété. En fonction de la taille du ProgressBar contrôle, la Value propriété détermine quand afficher le bloc suivant.

La façon la plus courante de mettre à jour la valeur de progression actuelle consiste à écrire du code pour définir la Value propriété. Dans l’exemple de chargement d’un fichier volumineux, vous pouvez définir la taille maximale du fichier en kilo-octets. Par exemple, si la Maximum propriété est définie sur 100, la Minimum propriété est définie sur 10 et la Value propriété est définie sur 50, 5 rectangles sont affichés. Il s’agit de la moitié du nombre qui peut être affiché.

Toutefois, il existe d’autres façons de modifier la valeur affichée par le ProgressBar contrôle, en plus de définir la Value propriété directement. La Step propriété peut être utilisée pour spécifier une valeur d’incrémentation de la Value propriété. Ensuite, l’appel de la PerformStep méthode incrémente la valeur. Pour varier la valeur d’incrément, vous pouvez utiliser la Increment méthode et spécifier une valeur avec laquelle incrémenter la Value propriété.

Un autre contrôle qui informe graphiquement l’utilisateur d’une action actuelle est le StatusBar contrôle.

Important

ToolStripStatusLabel Les StatusStrip contrôles remplacent et ajoutent des fonctionnalités aux StatusBar contrôlesStatusBarPanel. Toutefois, les StatusBar contrôles et StatusBarPanel les contrôles sont conservés pour la compatibilité descendante et l’utilisation ultérieure, si vous le souhaitez.

Voir aussi