Get View Offset Fraction
ScrollBoxЧто это
Pure-функция, возвращает текущую позицию прокрутки ScrollBox как долю от полного диапазона прокрутки. 0.0 соответствует началу (самый верх/лево), 1.0 — концу (самый низ/право). Удобна для синхронизации UI-элементов, сохранения/восстановления скролла или анимации.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (ScrollBox) — целевой виджет ScrollBox
Выходы (данные):
- ReturnValue (float) — текущее смещение в долях (0.0 … 1.0)
Когда используется
- Сохранение позиции скролла между открытиями UI (сериализация в SaveGame).
- Условное отображение кнопок «наверх»/«вниз» в зависимости от доли.
- Привязка индикатора прогресса чтения или полосы прокрутки другой вкладки.
Типичные проблемы
- Значение 0.0 — начало списка (первый элемент), 1.0 — конец (последний). Путаница с обратным порядком приводит к ошибочным скроллам.
- Если ScrollBox пуст или Target повреждён (например, уничтожен), возврат может быть 0.0 без предупреждения — требуется проверка IsValid перед вызовом.