On Preview Key Down
UserWidget
0
Что это
Событие, вызываемое при нажатии клавиши, когда виджет находится в фокусе. Выполняется до стандартной обработки OnKeyDown. Возвращает EventReply — если нужно забрать ввод себе и не передавать дальше, верните HandledEventReply, иначе — UnhandledEventReply.
Пины
Exec-входы:
- execute (exec) — запуск при срабатывании события.
Exec-выходы:
- then (exec) — продолжение после выполнения логики.
Входы (данные):
- MyGeometry (Geometry) — геометрия виджета (размер, положение в экранных координатах).
- InKeyEvent (Key Event) — информация о нажатии: какая клавиша, модификаторы, координаты.
Выходы (данные):
- ReturnValue (EventReply) — ответ, определяющий, обработано ли событие. Если не подключать — вернётся
UnhandledEventReply, и событие будет передано дальше.
Когда используется
- Кастомная обработка горячих клавиш на уровне виджета.
- Перехват ввода для кастомных контролов (виртуальные клавиатуры, игры, текстовые поля с особым поведением).
- Блокировка стандартного поведения при нажатии Esc, Enter и т.д.
Типичные проблемы
- Забытый возврат HandledEventReply — если событие нужно поглотить, а возвращается Unhandled, ввод уходит дальше (например, закрывает виджет).
- Игнорирование MyGeometry — при проверке попадания клавиши в конкретную область виджета обязательно учитывайте геометрию (локальные vs экранные координаты).
- Путаница с OnKeyDown —
OnPreviewKeyDownсрабатывает раньше. Если вернуть Handled,OnKeyDownне вызовется. Это может быть как полезно, так и неожиданно.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.