UIElement.PointerWheelChanged Событие

  • Ссылка

Определение

Пространство имен:
Windows.UI.Xaml
Изменить

Происходит при изменении разностного значения колесика указателя.

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" .../>

Тип события

PointerEventHandler

Комментарии

При обработке PointerWheelChanged обычно вас интересует значение свойства MouseWheelDelta :

  1. Вызовите GetCurrentPoint из указателя PointerRoutedEventArgs, доступного обработчику. Возвращает значение PointerPoint.
  2. Получение свойствобъекта PointerPoint. Он содержит объект PointerPointProperties .
  3. Получите значение свойства 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.

Применяется к

См. также раздел