Xamarin.Forms ProgressBar

Le Xamarin.FormsProgressBar contrôle représente visuellement la progression sous la forme d’une barre horizontale remplie à un pourcentage représenté par une float valeur. La classe ProgressBar hérite des données de l’élément View.

Les captures d’écran suivantes montrent un ProgressBar iOS et Android :

Le ProgressBar contrôle définit deux propriétés :

• Progress est une float 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.
• ProgressColor est un Color élément qui affecte la couleur de la barre intérieure représentant la progression actuelle.

Ces propriétés sont sauvegardées par BindableProperty des objets, ce qui signifie que le ProgressBar style peut être appliqué et être la cible des liaisons de données.

Le ProgressBar contrôle 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.

Remarque

La ProgressBar manipulation de l’utilisateur n’accepte pas la manipulation de manière à ce qu’elle soit ignorée lors de l’utilisation de la touche Tab pour sélectionner des contrôles.

Créer une barre de progression

Vous pouvez instancier un ProgressBar en XAML. Sa Progress propriété détermine le pourcentage de remplissage de la barre intérieure et colorée. La valeur de propriété par défaut Progress est 0. L’exemple suivant montre comment instancier un ProgressBar en XAML avec le jeu de propriétés Progress facultatif :

<ProgressBar Progress="0.5" />

Vous pouvez également créer un ProgressBar en code :

ProgressBar progressBar = new ProgressBar { Progress = 0.5f };

Avertissement

N’utilisez pas d’options de disposition horizontale non contraintes telles que Center, Startou End avec ProgressBar. Sur UWP, la ProgressBar valeur est réduite à une barre de zéro largeur. Conservez la valeur par défaut HorizontalOptions et n’utilisez pas de largeur lors de Fill Auto la mise ProgressBar en Grid page.

Propriétés d’apparence progressBar

La ProgressColor propriété définit la couleur de la barre interne lorsque la Progress propriété est supérieure à zéro. L’exemple suivant montre comment instancier un ProgressBar code XAML avec le jeu de ProgressColor propriétés :

<ProgressBar ProgressColor="Orange" />

La ProgressColor propriété peut également être définie lors de la création d’un ProgressBar code dans :

ProgressBar progressBar = new ProgressBar { ProgressColor = Color.Orange };

Les captures d’écran suivantes montrent l’utilisation ProgressBar de la ProgressColor propriété définie Color.Orange sur iOS et Android :

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 float valeur de progression, une uint durée en millisecondes, une Easing valeur enum et retourne un Task<bool>. Le code 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 Easing , consultez Fonctions d’accélération dans Xamarin.Forms.