Partager via


ProgressBar

L’interface utilisateur de l’application multiplateforme .NET (.NET MAUI) ProgressBar indique aux utilisateurs que l’application progresse dans une longue activité. La barre de progression est une barre horizontale qui est remplie à un pourcentage représenté par une double valeur.

L’apparence d’un ProgressBar est dépendante de la plateforme, et la capture d’écran suivante montre un ProgressBar sur Android :

Screenshot of ProgressBar on Android.

ProgressBar définit deux propriétés :

  • Progress est une double valeur qui représente la progression actuelle sous forme de valeur comprise entre 0 et 1. Progress les valeurs inférieures à 0 seront limitées à 0, les valeurs supérieures à 1 seront limitées à 1. La valeur par défaut de cette propriété est 0.
  • ProgressColor est une Color valeur qui définit la couleur du ProgressBar.

Ces propriétés sont sauvegardées par BindableProperty des objets, ce qui signifie qu’elles peuvent être des cibles de liaisons de données et mises en forme.

ProgressBar définit également une ProgressTo méthode qui anime la barre de sa valeur actuelle à une valeur spécifiée. Pour plus d’informations, consultez Animer une barre de progression.

Créer une barre de progression

Pour indiquer la progression d’une activité longue, créez un ProgressBar objet et définissez ses propriétés pour définir son apparence.

L’exemple XAML suivant montre comment afficher un ProgressBar:

<ProgressBar Progress="0.5" />

Le code C# équivalent est :

ProgressBar progressBar = new ProgressBar { Progress = 0.5 };

Avertissement

N’utilisez pas d’options de disposition horizontale non contraintes telles que Center, Startou End avec ProgressBar. Conservez la valeur par défaut HorizontalOptions de Fill.

L’exemple XAML suivant montre comment modifier la couleur d’un ProgressBar:

<ProgressBar Progress="0.5"
             ProgressColor="Orange" />

Le code C# équivalent est :

ProgressBar progressBar = new ProgressBar
{
    Progress = 0.5,
    ProgressColor = Colors.Orange
};

Animer une barre de progression

La ProgressTo méthode anime la ProgressBar valeur actuelle Progress vers une valeur fournie au fil du temps. La méthode accepte une double valeur de progression, une uint durée en millisecondes, une Easing valeur enum et retourne un Task<bool>. L’exemple suivant montre comment animer un ProgressBar:

// animate to 75% progress over 500 milliseconds with linear easing
await progressBar.ProgressTo(0.75, 500, Easing.Linear);

Pour plus d’informations sur l’énumération, consultez Fonctions d’accélérationEasing.