Drop
DragDropOperation
0
Что это
Событие (exec, не pure) Drop из класса DragDropOperation вызывается движком, когда пользователь отпускает перетаскиваемый объект (Drop) над целевым виджетом. Позволяет обработать действие — принять или отклонить дроп. Возвращает признак того, что событие обработано.
Пины
Exec-входы:
- execute (exec) — запуск события (вызывается движком)
Exec-выходы:
- then (exec) — продолжение выполнения после обработки события
Входы (данные):
- PointerEvent (FPointerEvent) — структура с данными указателя (координаты, клавиши, модификаторы)
- HitResult (FHitResult) — результат попадания под курсор в момент отпускания
- DraggedWidget (UWidget) — виджет, который был перетаскиваем, либо nullptr, если не задан
Выходы (данные):
- ReturnValue (bool) — верните
true, если дроп обработан (событие потребляется), иfalse, если он должен быть проигнорирован (движок может отменить дальнейшую обработку)
Когда используется
- Реализация drag-and-drop для виджетов в UMG: при отпускании перетаскиваемого элемента над зоной назначения.
- Перенос предметов между инвентарными слотами, перемещение элементов интерфейса, сортировка списков.
- В сочетании с событием
OnDragDetectedдля начала перетаскивания.
Типичные проблемы
- Неверное возвращаемое значение: если забыть вернуть
true, движок может повторно вызывать событие или не считать дроп обработанным, что приводит к игнорированию. - Путаница с PointerEvent: координаты
ScreenSpacePositionиLastScreenSpacePosition— это экранные координаты в пикселях, а не локальные относительно виджета; для локальных координат нужно использоватьHitResult. - Отсутствие проверки DraggedWidget: при обработке дропа следует проверять, какой именно виджет перетаскивается (например, по типу или тегу), иначе можно принять непредусмотренный элемент.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.