Navigate To Index
ListView
0
Что это
Функция Navigate To Index (exec) — перемещает фокус клавиатурной навигации в ListView на элемент с указанным индексом. Прокручивает список к этому элементу, если он не виден. Используется для программного управления выделением в списках с клавиатурной навигацией.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (ListView Object Reference) — сам ListView, к которому применяется навигация
- Index (Integer) — индекс элемента, на который нужно перевести фокус (0-based)
Выходы (данные):
- нет (void)
Когда используется
- Программное перемещение фокуса на определённый элемент списка (например, после добавления нового элемента).
- Реализация кастомной навигации с клавиатуры или геймпада.
- Восстановление фокуса после обновления данных списка.
Типичные проблемы
- Выход за границы массива — передача индекса, который меньше 0 или больше
(NumItems - 1), приводит к ошибке выполнения (краш или игнорирование вызова). - Пустой список — вызов
Navigate To Indexна ListView без элементов не имеет эффекта, но не вызывает ошибку. - Конфликт с пользовательским вводом — если пользователь одновременно управляет списком мышью/клавиатурой, программный вызов может быть переопределён следующим событием ввода.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.