On Mouse Move
UserWidgetЧто это
Событие (Event), вызываемое при движении указателя мыши в области виджета. Не pure, не async. Срабатывает только при фактическом изменении позиции мыши в клиентской области виджета.
Пины
Exec-входы:
- execute (exec) — срабатывает при движении мыши
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- My Geometry (Geometry) — пространственная информация виджета (размер, масштаб, положение в окне)
- Mouse Event (Pointer Event) — структура с координатами мыши, нажатыми кнопками и модификаторами клавиатуры
Выходы (данные):
- нет (void)
Когда используется
Обработка движений мыши в кастомных интерактивных виджетах: реализация drag‑and‑drop, кастомных курсоров, hover‑эффектов, элементов управления (слайдеры, поворотные ручки и т.п.).
Типичные проблемы
- Игнорирование масштабирования виджета: координаты
MouseEventлокальны относительноMy Geometry. При изменении DPI или масштаба контейнера координаты могут быть неожиданны, если не пересчитывать черезAchToLocal/LocalToAbsolute. - Слишком частые вызовы: событие генерируется на каждое пиксельное движение. Внутри не стоит делать тяжёлые вычисления или изменения состояния каждый кадр – лучше кэшировать результат или использовать таймер (например, для вызова по таймауту обновления отображения).
- Неявное ожидание «On Hover»:
OnMouseMoveне заменяетOnMouseEnter/OnMouseLeave. Для отслеживания входа/выхода курсора используйте соответствующие события, а не анализ предыдущей позиции.