UIElement.PointerWheelChanged Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при изменении разностного значения колесика указателя.
public:
virtual event PointerEventHandler ^ PointerWheelChanged;// Register
event_token PointerWheelChanged(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerWheelChanged(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerWheelChanged_revoker PointerWheelChanged(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerWheelChanged;function onPointerWheelChanged(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerwheelchanged", onPointerWheelChanged);
uIElement.removeEventListener("pointerwheelchanged", onPointerWheelChanged);
- or -
uIElement.onpointerwheelchanged = onPointerWheelChanged;Public Custom Event PointerWheelChanged As PointerEventHandler <uielement PointerWheelChanged = "eventhandler" .../>
Тип события
Комментарии
При обработке PointerWheelChanged обычно вас интересует значение свойства MouseWheelDelta :
- Вызовите GetCurrentPoint из указателя PointerRoutedEventArgs, доступного обработчику. Возвращает значение PointerPoint.
- Получение свойствобъекта PointerPoint. Он содержит объект PointerPointProperties .
- Получите значение свойства MouseWheelDelta из объекта PointerPointProperties . Положительное значение указывает, что колесо было повернуто вперед (в сторону от пользователя) или наклонилось вправо; Отрицательное значение указывает, что колесо было повернуло назад (к пользователю) или наклонилось влево.
Если элемент, в котором происходят события указателя, имеет значение ManipulationMode , отличное от значения по умолчанию, то это действие также может привести к различным событиям манипуляции, таким как ManipulationStarted. Кроме того, входные данные колесика мыши могут обрабатываться элементами управления как встроенное поведение манипуляции, даже если значение ManipulationMode не задано . Например, некоторые элементы управления, такие как GridView и ListView , могут обрабатывать ввод колесика мыши, чтобы инициировать действие прокрутки или сдвига.
PointerWheelChanged — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.
Для сенсорного ввода, а также событий, связанных с взаимодействием, или событий операций, которые являются следствием сенсорного ввода, элемент должен быть видимым для проверки нажатия. В таком случае элемент становится источником события и вызывает событие, сопоставленное с действием. UIElement.Visibility должен быть видимым. Другие свойства производных типов также влияют на видимость проверки попадания. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
PointerWheelChanged поддерживает возможность подключения обработчиков событий к маршруту, который будет вызываться, даже если данные события помечены как Handled. См . раздел AddHandler.
Определенные элементы управления среда выполнения Windows могут иметь обработку на основе классов для входного события PointerWheelChanged. В этом случае элемент управления, вероятно, имеет переопределение для метода OnPointerWheelChanged. Обычно событие помечается обработчиком класса, а событие PointerWheelChanged не вызывается для обработки обработчиками пользовательского кода в этом элементе управления. Элемент управления может сделать это для поддержки обхода своих дочерних элементов с помощью действия колесика указателя. Дополнительные сведения о том, как работает обработка событий на основе классов, см. в статье Обзор событий и перенаправленных событий.
Работа в Windows 8
В Windows 8 жесты устройства отслеживания панели, обрабатываемые элементом управления ScrollViewer , интерпретировались как ввод колесика мыши и, таким образом, вызвали событие PointerWheelChanged. Начиная с Windows 8.1, ScrollViewer использует базовую логику манипуляции, которая интерпретирует жесты панели отслеживания как действия, на которые реагирует ScrollViewer, поэтому жест считается обрабатываемым элементом управления, а событие PointerWheelChanged больше не активируется.
При переносе кода приложения из Windows 8 в Windows 8.1 может потребоваться учесть это изменение поведения, так как это приводит к тому, что PointerWheelChanged запускается в меньшем количестве случаев. Кроме того, поведение, которое теперь встроено в ScrollViewer , может дублировать то, что сделал бы обработчик.
Приложения, которые скомпилированы для Windows 8, но выполняются в Windows 8.1, продолжают использовать правила, действующие в Windows 8.