Get Active Widget Index
WidgetSwitcher
0
Что это
Pure-функция, возвращающая индекс текущего активного дочернего виджета в контейнере WidgetSwitcher. Индексация начинается с 0. Если контейнер пуст, возвращается -1. Функция не изменяет состояние, не имеет exec-пинов.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (WidgetSwitcher Object Reference) — ссылка на виджет-свитчер, у которого запрашивается активный индекс.
Выходы (данные):
- Return Value (Integer) — индекс активного виджета (0-based) или
-1, если детей нет.
Когда используется
- Когда нужно узнать, какой именно дочерний виджет сейчас отображается в
WidgetSwitcher, чтобы, например, синхронизировать с другими элементами интерфейса (кнопки переключения, индикаторы страниц). - В логике условного отображения контента, когда активный виджет определяет поведение остальной части UI.
Типичные проблемы
- Не проверяют возвращаемое значение на
-1— если контейнер пуст, индекс будет-1, и попытка использовать его как индекс массива или передать в другую функцию может привести к ошибке. - Путают с
GetActiveWidget— эта функция возвращает сам виджет (объект), а не его индекс. Если нужен именно индекс, используютGetActiveWidgetIndex. - Считают, что индекс всегда валиден — после удаления или добавления виджетов индексы могут сместиться; активный индекс может указывать на другой виджет, если не обновлять его явно через
SetActiveWidgetIndex.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.