Xamarin.Forms ProgressBar

Ukázka stažení Stažení ukázky

Xamarin.FormsProgressBar Ovládací prvek vizuálně reprezentuje průběh jako vodorovný pruh, který je vyplněn procentem reprezentovaným float hodnotou. ProgressBarTřída dědí z View .

Následující snímky obrazovky ukazují ProgressBar na iOS a Android:

Snímek obrazovky ProgressBar v iOS a Androidu

ProgressBarOvládací prvek definuje dvě vlastnosti:

Tyto vlastnosti jsou zálohovány BindableProperty objekty, což znamená, že je ProgressBar možné styl a být cílem datových vazeb.

ProgressBarOvládací prvek také definuje ProgressTo metodu, která animuje pruh z aktuální hodnoty na zadanou hodnotu. Další informace najdete v tématu animace ovládacího prvku ProgressBar.

Poznámka

ProgressBarNepřijímá manipulaci s uživatelem, takže je přeskočen při použití klávesy TAB k výběru ovládacích prvků.

Vytvoření ovládacího prvku ProgressBar

ProgressBarLze vytvořit instanci v jazyce XAML. Jeho Progress vlastnost určuje procentuální hodnotu výplně vnitřního, barevného pruhu. Výchozí Progress hodnota vlastnosti je 0. Následující příklad ukazuje, jak vytvořit instanci ProgressBar v jazyce XAML s volitelnou Progress sadou vlastností:

<ProgressBar Progress="0.5" />

ProgressBarLze také vytvořit v kódu:

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

Upozornění

Nepoužívejte možnosti horizontálního rozložení bez omezení, jako například Center , Start nebo End s ProgressBar . U UWP se ProgressBar sbalí na panel s nulovou šířkou. Zachovat výchozí HorizontalOptions hodnotu Fill a nepoužívat šířku Auto při vkládání do ProgressBarGrid rozložení.

Vlastnosti zobrazení ProgressBar

ProgressColorVlastnost definuje vnitřní barvu čáry, pokud Progress je vlastnost větší než nula. Následující příklad ukazuje, jak vytvořit instanci ProgressBar v jazyce XAML se ProgressColor sadou vlastností:

<ProgressBar ProgressColor="Orange" />

ProgressColorVlastnost lze nastavit také při vytváření ProgressBar v kódu:

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

Následující snímky obrazovky ukazují ProgressBarProgressColor vlastnost s vlastností nastavenou na Color.Orange v systémech iOS a Android:

Snímek obrazovky se stylem ProgressBar na zařízeních s iOS a Androidem

Animace ovládacího prvku ProgressBar

ProgressToMetoda animuje ProgressBar z aktuální Progress hodnoty na zadanou hodnotu v čase. Metoda přijímá float hodnotu průběhu, uint dobu v milisekundách, Easing hodnotu výčtu a vrátí Task<bool> . Následující kód ukazuje, jak animovat ProgressBar :

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

Další informace o výčtu naleznete Easing v tématu Easing functions in Xamarin.Forms .