Add Child To Horizontal Box
HorizontalBoxЧто это
Функция добавляет дочерний виджет в конец горизонтальной панели (HorizontalBox). Возвращает слот (HorizontalBoxSlot), через который можно настроить отступы, выравнивание и размеры добавленного элемента. Это exec-функция (не pure).
Пины
Exec-входы:
- execute (exec) — запуск добавления
Exec-выходы:
- then (exec) — продолжение выполнения после добавления
Входы (данные):
- Target (HorizontalBox) — сама панель, в которую добавляется виджет
- Content (Widget) — добавляемый дочерний виджет
Выходы (данные):
- ReturnValue (HorizontalBoxSlot) — слот добавленного виджета для настройки его свойств
Когда используется
При динамическом создании интерфейса: когда нужно программно добавить кнопку, текст, изображение или другой виджет в горизонтальный ряд. Часто применяется в HUD, меню, инвентарях и панелях инструментов.
Типичные проблемы
- Забывают сохранить возвращаемый слот (ReturnValue) — без него нельзя настроить отступы и выравнивание добавленного элемента.
- Добавляют виджет, который уже имеет родителя (принадлежит другой панели) — это вызовет ошибку или неожиданное перемещение. Перед добавлением нужно извлечь виджет из предыдущей панели (Remove from Parent).
- Путают с Add Child to Canvas Panel или Add Child to Vertical Box — у HorizontalBox слот имеет свои свойства (ориентация по горизонтали), и настройки выравнивания работают иначе.