ProgressBar
Линейный индикатор прогресса, отображающий детерминированное или неопределенное состояние выполнения.
Обзор
ProgressBar обеспечивает визуальную обратную связь о ходе выполнения задачи с помощью детерминированного заполнения или анимированного индикатора активности.
Ключевые возможности:
- Настраиваемый диапазон значений с помощью min, max и текущего value.
- Расчет относительного прогресса от 0.0 до 1.0 (progress()).
- Неопределенный (indeterminate) режим для операций неизвестной длительности.
- Настраиваемый визуальный стиль дорожки и индикатора.
Настройка детерминированного и неопределенного прогресс-бара
Связанные ссылки
- LoadingIndicator: Виджет индикатора загрузки с поддержкой режимов кольца, полосы, пульсации и точек.
API
ProgressBar()
Создает ProgressBar с диапазоном по умолчанию от 0 до 100.
ProgressBar::indeterminate()
Возвращает true, если индикатор работает в неопределенном режиме анимации.
Возвращает boolean: True, если индикатор работает в неопределенном режиме..
ProgressBar::indeterminate(boolean)
Устанавливает флаг неопределенного режима анимации.
| Параметр | Тип | Описание |
|---|---|---|
indeterminate |
boolean |
Работает ли индикатор прогресса в неопределенном режиме. |
Возвращает ProgressBar: Текущий экземпляр виджета для цепочки вызовов..
ProgressBar::max()
Возвращает максимальное значение прогресса.
Возвращает float: Текущий нормализованный прогресс от 0.0 до 1.0..
ProgressBar::max(float)
Устанавливает максимальное значение прогресса.
| Параметр | Тип | Описание |
|---|---|---|
max |
float |
Верхняя граница диапазона. |
Возвращает ProgressBar: Текущий экземпляр виджета для цепочки вызовов..
ProgressBar::min()
Возвращает минимальное значение прогресса.
Возвращает float: Текущий нормализованный прогресс от 0.0 до 1.0..
ProgressBar::min(float)
Устанавливает минимальное значение прогресса.
| Параметр | Тип | Описание |
|---|---|---|
min |
float |
Нижняя граница диапазона. |
Возвращает ProgressBar: Текущий экземпляр виджета для цепочки вызовов..
ProgressBar::progress()
Возвращает нормализованный прогресс от 0.0 до 1.0.
Возвращает float: Текущий нормализованный прогресс от 0.0 до 1.0..
ProgressBar::range(float, float)
Устанавливает одновременно минимальную и максимальную границы диапазона.
| Параметр | Тип | Описание |
|---|---|---|
min |
float |
Нижняя граница диапазона. |
max |
float |
Верхняя граница диапазона. |
Возвращает ProgressBar: Текущий экземпляр виджета для цепочки вызовов..
ProgressBar::value()
Возвращает текущее значение прогресса.
Возвращает float: Текущий нормализованный прогресс от 0.0 до 1.0..
ProgressBar::value(float)
Устанавливает текущее значение прогресса.
| Параметр | Тип | Описание |
|---|---|---|
value |
float |
Значение прогресса. |
Возвращает ProgressBar: Текущий экземпляр виджета для цепочки вызовов..