UIElement.PointerWheelChanged イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ポインター ホイールのデルタ値が変更されたときに発生します。
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 プロパティの値に関心があります。
- ハンドラーで使用できる PointerRoutedEventArgs から GetCurrentPoint を呼び出します。 これにより 、PointerPoint が返されます。
- PointerPoint のプロパティを取得します。 PointerPointProperties オブジェクトが含まれています。
- PointerPointProperties オブジェクトから MouseWheelDelta プロパティ値を取得します。 正の値は、ホイールが前方 (ユーザーから離れて) 回転したか、右に傾いていたことを示します。負の値は、ホイールが (ユーザーに向かって) 後方に回転したか、左に傾いていたことを示します。
ポインター イベントが発生する要素に既定以外の ManipulationMode 値がある場合、そのアクションによって ManipulationStarted などのさまざまな操作イベントが発生する可能性もあります。 さらに、 ManipulationMode 値が設定されていない場合でも、マウス ホイール入力はコントロールによって組み込みの操作動作として処理できます。 たとえば、 GridView や ListView などの特定のコントロールでは、マウス ホイール入力を処理してスクロール/パン アクションを開始できます。
PointerWheelChanged はルーティング イベントです。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タッチ操作や、タッチ操作の結果に発生する対話/操作イベントについては、ヒット テストで要素が表示されない場合、イベント ソースとして使用したり、操作に関連付けられたイベントを起動することはできません。 UIElement.Visibility は Visible である必要があります。 派生型の他のプロパティも、ヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
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 のときと同じ動作になります。