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 必須是 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 的行為。

適用於

另請參閱