HasAnyUserFocusedDescendants
WidgetЧто это
Pure-функция, проверяющая, имеет ли виджет (или любой из его потомков) фокус ввода от любого пользователя (локального или сетевого). Возвращает true, если хотя бы один потомок в данный момент сфокусирован. Полезна для кастомной навигации, подсветки активных элементов или определения, находится ли пользователь внутри сложного составного виджета.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (Widget Object Reference) — виджет, для которого (и чьих потомков) выполняется проверка.
Выходы (данные):
- Return Value (Boolean) —
true, если виджет или любой из его потомков имеет фокус ввода от любого пользователя.
Когда используется
- Определение, активен ли кастомный джойстик или меню (если у него есть сфокусированный потомок).
- Скрытие/показ подсказок или тултипов, когда пользователь взаимодействует с дочерними элементами составного виджета.
- Условное выполнение логики (например, обновление состояния) только когда виджет или его часть находится в фокусе.
Типичные проблемы
- Путаница с
HasUserFocusedDescendants(без «Any»):HasAnyUserFocusedDescendantsпроверяет фокус от любого пользователя (включая сетевых), аHasUserFocusedDescendants— только от конкретного (требует дополнительный пинPlayerController). Использование не той функции может привести к неверным результатам в мультиплеере. - Игнорирование pure-природы: Функция не имеет exec-пинов, поэтому её результат должен быть получен и использован в том же потоке выполнения (например, подключён к Branch). Попытка «вызвать» её как exec-функцию — синтаксическая ошибка в Blueprint.
- Проверка на неинициализированном виджете: Если виджет ещё не добавлен в вьюпорт (не инициализирован), функция может вернуть
false, даже если логически он должен быть в фокусе. Всегда проверяйтеIsValidперед вызовом.