Navigate To Item
ListView
0
Что это
Exec-функция для программной навигации ListView к указанному элементу. Перемещает фокус и выделение на заданный объект в списке без действий пользователя. Не является pure-функцией (требует exec-соединений).
Пины
Exec-входы:
- execute (exec) — точка запуска
Exec-выходы:
- then (exec) — выполнение после навигации
Входы (данные):
- Target (ListView) — ссылка на ListView-виджет
- Item (Object) — целевой элемент (должен присутствовать в источнике данных)
Выходы (данные):
- нет (void)
Когда используется
- Восстановление состояния списка при загрузке сохранений.
- Программная синхронизация выделения после обновления SourceItems.
- Переход к определённому элементу в сценарии инвентаря, меню или списка миссий.
Типичные проблемы
- Item не является элементом списка — если объект отсутствует в SourceItems, навигация игнорируется.
- Null Item — передача None приводит к отсутствию эффекта, при этом ошибка не выбрасывается.
- Непреднамеренное отсутствие фокуса — функция не гарантирует видимость элемента на экране; для прокрутки к элементу может потребоваться дополнительный вызов
Scroll Item Into View.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.