Set Hand Start End Ratio
RadialSliderЧто это
Exec-функция виджета RadialSlider. Устанавливает начальную и конечную доли (в диапазоне 0–1), определяющие видимый сегмент ручки (hand) на круговом слайдере. Позволяет ограничить доступную область перемещения ползунка или отобразить диапазон значений.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- StartRatio (float) — начальная доля окружности (0 = верх, 0.25 = правый край, 0.5 = низ, 0.75 = левый край)
- EndRatio (float) — конечная доля окружности (должна быть больше StartRatio для корректного отображения)
Выходы (данные):
- нет (void)
Когда используется
При динамической настройке диапазона ручки RadialSlider, например, чтобы показывать только определённый сектор шкалы (температура, уровень заряда, прогресс). Также для синхронизации с внешними данными, где ползунок должен перемещаться только внутри заданного интервала.
Типичные проблемы
- Выход за границы [0, 1]: значения StartRatio или EndRatio меньше 0 или больше 1 приводят к неопределённому поведению отрисовки (может отображаться весь круг или ничего).
- StartRatio > EndRatio: при таком порядке ручка может отображаться некорректно (инвертированный сектор). Рекомендуется проверять, что StartRatio ≤ EndRatio.
- Забыли вызвать после изменения свойств: если менять значения динамически (например, по таймеру), без вызова этой функции виджет не обновится.