Set Percent
ProgressBarЧто это
Функция Set Percent (C++ SetPercent) — exec-метод виджета ProgressBar, устанавливающий текущий процент заполнения шкалы. Передаваемое значение нормализуется в диапазоне 0.0–1.0; использование вне этого диапазона приводит к автоматическому отсечению.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (ProgressBar Object Reference) — ссылка на изменяемый прогресс-бар (автоматически self)
- Percent (float) — значение заполнения в долях от 1.0 (0.0 = пусто, 1.0 = полностью)
Выходы (данные):
- нет (void)
Когда используется
Для динамической индикации загрузки, здоровья, таймеров, шкал прогресса в UI. Часто применяется в циклах, при обновлении числовых параметров или по событию изменения состояния.
Типичные проблемы
- Выход за пределы 0–1: хотя движок обрезает значение, передача процента в виде «50» вместо «0.5» приводит к заполнению до 100% (единица). Всегда нормируйте значение (например,
Current / Max). - Игнорирование стиля: если у ProgressBar установлен стиль с собственным переопределением отрисовки (например, через
Fill Image),Set Percentможет не давать видимого эффекта — проверьте настройки виджета.