UIElement.PointerMoved Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при перемещении указателя, пока указатель остается в области теста попадания этого элемента.
public:
virtual event PointerEventHandler ^ PointerMoved;// Register
event_token PointerMoved(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerMoved(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerMoved_revoker PointerMoved(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerMoved;function onPointerMoved(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointermoved", onPointerMoved);
uIElement.removeEventListener("pointermoved", onPointerMoved);
- or -
uIElement.onpointermoved = onPointerMoved;Public Custom Event PointerMoved As PointerEventHandler <uiElement PointerMoved="eventhandler"/>
Тип события
Комментарии
Взаимодействия касания, мыши и пера и пера и пера, обрабатываются и управляются как входные данные указателя в приложении UWP. Любое из этих взаимодействий PointerMoved может создать событие. Дополнительные сведения см. в разделе "Ввод указателя указателя" и раздел "PointerMoved для ввода мыши и пера" этого раздела.
В некоторых сценариях пользовательского интерфейса, особенно если пользователь использует мышь, это событие будет работать много. Помните о профиле производительности кода, который вы помещаете в этот обработчик, и рассмотрите способы использования собственных флагов или допустимых значений, которые могут регулировать количество операций логики.
Это событие является перенаправленным событием. Дополнительные сведения о концепции перенаправленного события см. в разделе "События" и обзор перенаправленных событий.
Для действий касания, а также для событий взаимодействия или манипуляций, которые являются последствиями сенсорного действия, элемент должен быть видимым, чтобы быть источником события и запускать событие, связанное с действием. UIElement.Видимость должна быть видимой. Другие свойства производных типов также влияют на видимость попадания в тест. Дополнительные сведения см. в разделе "События" и обзор перенаправленных событий.
Это событие также поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться даже в том случае, если данные события для события помечены как Handled. См. раздел AddHandler.
PointerMoved для ввода мыши и пера
Устройство ввода мыши имеет экранный курсор, видимый при перемещении мыши по границам элемента, даже если в то время кнопка мыши не нажимается. Аналогичное поведение доступно для ввода ввода устройства пера, где входные устройства могут обнаружить, что перо наведено на поверхность входного устройства, но не касается его. Таким образом PointerMoved , входные данные мыши и пера будут запускать события чаще, чем сенсорные входные данные. Дополнительные сведения см. в разделе "Взаимодействие с мышью".
В отличие от этого, точка касания может быть обнаружена только в том случае, если палец касается поверхности. Точка касания будет создаваться PointerMoved только в то время как эта точка касания остается в постоянном контакте с поверхностью по мере перемещения. Для таких видов сенсорных действий, которые создаются PointerMoved , также вероятно, что действие будет обработано как манипуляция или как жест. Дополнительные сведения см. в разделе "Ввод указателя на дескриптор".
Входные данные мыши связаны с одним указателем, назначенным при первом обнаружении ввода мыши, и все взаимодействия, инициированные мышью, имеют одинаковый PointerId. Нажатие кнопки мыши (влево, колесо или вправо) создает вторичную связь между указателем и этой кнопкой через событие PointerPressed . Событие PointerReleased запускается только при освобождении той же кнопки мыши (пока это событие не будет завершено, кнопка не может быть связана с указателем). Из-за этой эксклюзивной связи другие нажатия кнопки мыши направляются через PointerMoved событие. При обработке этого события можно проверить состояние кнопки мыши, как показано в следующем примере:
Некоторые приложения, такие как игры, должны отслеживать относительные движения мыши для определенных функций (например, виртуальной трекбол или камеры просмотра) и не использовать системный курсор или абсолютные координаты экрана. Дополнительные сведения о скрытии курсора мыши и пропускании абсолютных данных мыши см. в разделе "Относительное перемещение мыши" и "CoreWindow".