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. 처리기에서 사용할 수 있는 PointerRoutedEventArgs에서 GetCurrentPoint를 호출합니다. 그러면 PointerPoint가 반환됩니다.
2. PointerPoint의 속성을 가져옵니다. PointerPointProperties 개체를 포함합니다.
3. PointerPointProperties 개체에서 MouseWheelDelta 속성 값을 가져옵니다. 양수 값은 휠이 앞으로 회전(사용자로부터 멀어지거나 오른쪽으로 기울어짐)임을 나타냅니다. 음수 값은 휠이 뒤로(사용자쪽으로) 회전했거나 왼쪽으로 기울어져 있음을 나타냅니다.

포인터 이벤트가 발생하는 요소에 기본값이 아닌 ManipulationMode 값이 있는 경우 작업으로 인해 ManipulationStarted와 같은 다양한 조작 이벤트가 발생할 수도 있습니다. 또한 ManipulationMode 값이 설정되지 않은 경우에도 마우스 휠 입력을 컨트롤에 의해 기본 제공 조작 동작으로 처리할 수 있습니다. 예를 들어 GridView 및 ListView 와 같은 특정 컨트롤 은 마우스 휠 입력을 처리하여 스크롤/이동 작업을 시작할 수 있습니다.

PointerWheelChanged는 라우트된 이벤트입니다. 라우트된 이벤트 개념에 대한 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

터치 동작의 경우와 터치 동작의 결과인 조작 관련 또는 조작 이벤트의 경우에도 이벤트 원본이 되거나 터치 동작과 연관된 이벤트를 실행하려면 요소의 적중 횟수 테스트가 보여야 합니다. UIElement.Visibility 는 표시되어야 합니다. 파생 형식의 다른 속성도 적중 테스트 표시 유형에 영향을 미칩니다. 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

PointerWheelChanged는 이벤트에 대한 이벤트 데이터가 처리됨으로 표시된 경우에도 호출될 경로에 이벤트 처리기를 연결하는 기능을 지원 합니다. 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 동작을 계속 사용합니다.

추가 정보

• PointerRoutedEventArgs
• 포인터 입력 처리
• 상대 마우스 이동 및 CoreWindow