On Preview Mouse Button Down
UserWidgetЧто это
Событие, вызываемое при нажатии кнопки мыши на виджете до обработки основного события OnMouseButtonDown. Позволяет перехватить нажатие и вернуть FReply, блокируя или пропуская дальнейшую обработку. Exec-событие (не pure, не async).
Пины
Exec-входы:
Нет (событие срабатывает автоматически при возникновении ввода).
Exec-выходы:
- then (exec) — продолжение выполнения после возврата из события.
Входы (данные):
- MyGeometry (Geometry) — геометрия виджета, в области которого произошло нажатие.
- MouseEvent (PointerEvent) — данные о событии мыши (кнопка, позиция, модификаторы).
Выходы (данные):
- ReturnValue (FReply) — результат обработки.
FReply::Handled()— поглотить событие (дальше не пойдёт);FReply::Unhandled()— продолжить стандартную цепочку.
Когда используется
- Для перехвата кликов до стандартной обработки, например, в кастомных интерактивных виджетах (карты, графики, мини-игры).
- Для реализации захвата мыши или изменения поведения кнопок без переопределения всего
OnMouseButtonDown.
Типичные проблемы
- Забывают вернуть
FReply::Unhandled()для событий, которые должны передаваться дальше, из-за чего остальные виджеты не получают нажатия. - Пытаются изменить
MouseEventнапрямую (он только для чтения), вместо создания новогоFReplyс нужным состоянием (например,FReply::Handled().SetUserFocus(...)). - Не учитывают, что это событие срабатывает до
OnMouseButtonDown, и изменения, сделанные здесь, могут не отразиться на последующей стандартной обработке (если не вернутьHandled).