Create Widget
WidgetBlueprintLibraryЧто это
Статическая функция библиотеки WidgetBlueprintLibrary для создания экземпляра виджета (UUserWidget) заданного класса во время выполнения. Является exec-функцией (не pure). Используется для динамического добавления UI-элементов, которые не были размещены на экране заранее.
Пины
Exec-входы:
- execute (exec) — запуск создания виджета
Exec-выходы:
- then (exec) — выполняется после создания виджета
Входы (данные):
- World Context Object (Object) — контекст мира (обычно Self, GameInstance или PlayerController)
- Class (Widget Class) — класс создаваемого виджета (должен быть наследником UUserWidget)
- Owning Player (Player Controller) — игрок-владелец виджета (может оставаться пустым, но влияет на ввод и фокус)
Выходы (данные):
- Return Value (Widget) — созданный экземпляр виджета (UUserWidget)
Когда используется
При динамическом создании окон, инвентарей, HUD-элементов, всплывающих подсказок и других UI-компонентов, которые должны появляться в ответ на действия игрока или события.
Типичные проблемы
- Не указан Owning Player — виджет может не получить корректный Player Controller, что приведёт к проблемам с обработкой ввода и фокусом.
- Не сохранён Return Value в переменную — созданный виджет будет немедленно уничтожен сборщиком мусора, так как на него не останется ссылок.
- Передан неподходящий класс (не наследник UUserWidget) — нода выдаст ошибку компиляции.