ProgressIndicator контроль

Стаття
03/21/2023

Елемент керування використовується для створення інтерфейсу завантаження.

Нотатка

Повна документація та вихідний код із репозиторію компонентів коду GitHub.

Управління індикатором прогресу.

Опис

Показники перебігу використовуються для відображення стану виконання операції, яка триває понад дві секунди. Якщо стан виконання не можливо визначити, використовуйте натомість Spinner, або використайте тип Indeterminate Indicator. Показники перебігу можуть з’являтися у новій області в спливаючому вікні під інтерфейсом користувача, який ініціював операцію, або навіть замінювати інтерфейс, з якого викликаються, якщо інтерфейс може повернутися, якщо скасувати або зупинити справу.

Цей компонент коду надає обгортку навколо елемента керування Fluent UI ProgressIndicator для використання на полотні та користувацьких сторінках. Див. документацію компонента для отримання рекомендацій.

Властивості

Ключові властивості

Властивість	Опис
`Label`	Необов’язковий підпис для індикатора перебігу.
`Percentage Complete`	Відсоток завершення операції, за шкалою від 0 до 1. Якщо не встановлено, відображатиметься «Невизначений індикатор».
`TypeOfIndicator`	Визначає тип стилю індикатора. Варіанти: `Default Indicator` або `IndeterminateIndicator`
`HideProgressState`	Задайте значення true, щоб приховати стан перебігу виконання
`BarHeight`	Укажіть висоту смуги, якщо застосовно

Властивості стилю

Властивість	Опис
`Theme`	Приймає рядок JSON, створений за допомогою конструктора тем Fluent UI (windows.net). Якщо залишити це значення пустим, використовуватиметься тема, визначена Power Apps. Див. використання тем, щоб отримати вказівки щодо налаштування.
`AccessibilityLabel`	Підпис aria-label для невізуальних екранів

Поведінка

Відображення перебігу виконання операції завантаження

Зробіть елемент керування ProgressIndicator (або поверхню, на якій його розташовано) видимим після початку процесу, а потім оновлюйте змінну, надаючи значення поступово при завершенні сегментів процесу. Приховайте, коли процес завершиться. Використовуйте змінну для керування видимістю елемента керування, оновлюйте значення між завершенням важливих блоків коду, що відповідають за процес, стан перебігу якого необхідно відобразити.

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 });

Укажіть змінну var_showProgress як значення властивості Visible елемента ProgressIndicator (або поверхні, яка його містить), і призначте змінну var_progressValue для властивості Value.

Обмеження

Цей компонент полотна можна використовувати лише в компонованих програмах і настроюваних сторінках.

Поділитися через