Share via

UIElement.PointerWheelChanged 事件

  • 參考

定義

命名空間:
Microsoft.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 支援將事件處理常式附加至將叫用的路由的能力，即使事件的事件資料標示為 Handled也一樣。 請參閱 AddHandler。

特定Windows 執行階段控制項可能會有 PointerWheelChanged 輸入事件的類別型處理。 如果是，控制項可能具有 OnPointerWheelChanged方法的覆寫。 一般而言，事件會標示為由類別處理常式處理，而且 PointerWheelChanged 該控制項上的任何使用者程式碼處理常式都不會引發 事件來處理。 控制項可能會執行此動作，以支援其子項目的周遊，方法是使用指標滾輪動作。 如需事件類別型處理運作方式的詳細資訊，請參閱 事件和路由事件概觀。

適用於

另請參閱