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

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é.

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

Les propriétés clés du contrôle ProgressBar sont Value, Minimumet Maximum. Les propriétés Minimum et Maximum définissent les valeurs maximales et minimales que la barre de progression peut afficher. La propriété Value représente la progression réalisée pour mener à bien 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 contrôle ProgressBar ne correspond qu’à la valeur actuelle de la propriété Value. En fonction de la taille du contrôle ProgressBar, la propriété Value 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 propriété Value. 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 propriété Maximum est définie sur 100, la propriété Minimum est définie sur 10 et la propriété Value 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 contrôle ProgressBar, en plus de définir directement la propriété Value. La propriété Step peut être utilisée pour spécifier une valeur pour incrémenter la propriété Value. Ensuite, l’appel de la méthode PerformStep incrémente la valeur. Pour varier la valeur d’incrément, vous pouvez utiliser la méthode Increment et spécifier une valeur avec laquelle incrémenter la propriété Value.

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

Voir aussi

• ProgressBar
• Contrôle de la barre de progression