ProgressIndicator řízení

Článek
03/21/2023

Ovládací prvek používaný k vytvoření prostředí pro načítání.

Poznámka:

Úplná dokumentace a zdrojový kód jsou k dispozici v úložišti komponent kódu GitHubu.

Ovládací prvek ProgressIndicator.

Description

Indikátory průběhu se používají k zobrazení stavu dokončení operace trvající déle než dvě sekundy. Pokud nelze stav postupu určit, použijte místo toho ovládací prvek Spinner nebo použít typ Indeterminate Indicator. Indikátory průběhu se mohou objevit v novém panelu, plovoucím okně, pod uživatelským rozhraním spouštějícím operaci nebo dokonce nahrazující spouštěcí uživatelské rozhraní, pokud se uživatelské rozhraní může vrátit, pokud zrušíte nebo zastavíte aktivitu.

Tato komponenta kódu poskytuje obálku kolem ovládacího prvku Fluent UI ProgressIndicator pro použití v aplikacích plátna a vlastních stránkách. Osvědčené postupy naleznete v dokumentaci komponent.

Vlastnosti

Hlavní vlastnosti

Vlastnost	Description
`Label`	Volitelný štítek pro spinner.
`Percentage Complete`	Procento dokončené operace na stupnici od 0 do 1. Pokud není nastaveno, zobrazí se neurčitý indikátor.
`TypeOfIndicator`	Určuje typ stylu indikátoru. Volby: `Default Indicator` nebo `IndeterminateIndicator`
`HideProgressState`	Chcete-li skrýt stav průběhu, zadejte hodnotu true
`BarHeight`	Podle potřeby zadejte výšku panelu

Vlastnosti stylu

Vlastnost	Description
`Theme`	Přijímá řetězec JSON, který je generován pomocí návrháře motivů Fluent UI (windows.net). Ponecháte-li toto prázdné, použije se výchozí motiv definovaný Power Apps. Nápovědu ke konfiguraci naleznete v části motivy.
`AccessibilityLabel`	Popisek Aria pro čtečky obrazovky

Chování

Zobrazit průběh načítání

Zviditelněte samotný ovládací prvek ProgressIndicator (nebo plochu, na které je umístěn) při zahájení procesu a poté aktualizujte proměnnou s hodnotou, jakmile jsou segmenty procesu dokončeny. Skryjte ho po dokončení procesu. Použijte proměnnou k ovládání viditelnosti ovládacího prvku a aktualizaci hodnot mezi hlavními bloky kódu procesu, které potřebují indikaci.

UpdateContext({ var_showProgress: true , var_progressValue: 0 });

/* Some code ... */

UpdateContext({ var_progressValue: 25 });

/* Some code ... */

UpdateContext({ var_progressValue: 50 });

/* Some code ... */

UpdateContext({ var_progressValue: 75 });

/* Some code ... */

UpdateContext({ var_progressValue: 100 });

Notify("Successfully completed process", NotificationType.Success);

UpdateContext({ var_showProgress: false });

Poskytněte proměnnou var_showProgress jako hodnotu pro vlastnost Visible indikátoru ProgressIndicator (nebo povrch, který jej obsahuje) a přiřaďte proměnnou var_progressValue pro vlastnost Value.

Omezení

Tuto komponentu plátna lze použít pouze v aplikacích plátna a vlastních stránkách.

Sdílet prostřednictvím