Виджет ProgressBar
Полоска прогресса — показываем, сколько осталось ждать
Что такое ProgressBar?
gui.ProgressBar — это заполняемая полоска, которая наглядно показывает прогресс выполнения какого-либо процесса.
Вы наверняка видели такие в реальной жизни:
- 📥 Загрузка файла в браузере — полоска заполняется от 0% до 100%
- 🎮 Шкала здоровья персонажа в игре
- 💾 Установка программы — «Осталось 3 секунды...»
- ⏳ Таймер обратного отсчёта в виде заполняющейся полоски
Вот как выглядит простейший прогрессбар, заполненный на 24%:
Стандартные свойства виджетов
Как и все виджеты в Idyllium, ProgressBar имеет стандартный набор свойств для позиционирования:
x— расстояние от левого края окна (в пикселях)y— расстояние от верхнего края окна (в пикселях)width— ширина виджетаheight— высота виджета
Эти свойства есть у каждого виджета — от кнопки до выпадающего списка.
Свойство value — уровень заполнения
Главное свойство прогрессбара — value. Оно имеет тип int и задаёт заполнение в процентах (от 0 до 100).
Три прогрессбара с разными значениями:
value = 0 — пусто, value = 50 — половина, value = 100 — полностью заполнено.
Обратите внимание: процент заполнения отображается прямо на полоске — дополнительный лейбл не нужен.
Динамическое изменение значения
Как и любые другие свойства, value можно менять во время работы программы. Вот пример, где кнопка устанавливает прогрессбару случайное значение:
Этот механизм можно использовать для:
- Отображения прогресса загрузки файлов
- Индикации здоровья персонажа в игре
- Визуализации таймера или обратного отсчёта
- Любого другого процесса, где нужно показать, «сколько осталось»