UIElement.ManipulationStarted 事件

  • 參考

定義

命名空間:
Windows.UI.Xaml
編輯

當輸入裝置開始在 UIElement 進行操作時發生。

// Register
event_token ManipulationStarted(ManipulationStartedEventHandler const& handler) const;

// Revoke with event_token
void ManipulationStarted(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::ManipulationStarted_revoker ManipulationStarted(auto_revoke_t, ManipulationStartedEventHandler const& handler) const;
public event ManipulationStartedEventHandler ManipulationStarted;
function onManipulationStarted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarted", onManipulationStarted);
uIElement.removeEventListener("manipulationstarted", onManipulationStarted);
- or -
uIElement.onmanipulationstarted = onManipulationStarted;
Public Custom Event ManipulationStarted As ManipulationStartedEventHandler 
<uiElement ManipulationStarted="eventhandler"/>

事件類型

ManipulationStartedEventHandler

備註

如需自訂控制項和互動體驗，請參閱 GestureRecognizer.ManipulationStarted。

ManipulationStarted 表示操作辨識邏輯偵測到指標移動。 在此情況下，第二個操作事件會在一般序列中引發、在 ManipulationStarting 之後引發，但在 ManipulationDelta 或其他事件之前，例如 ManipulationInertiaStarting。

專案必須具有None或System以外的ManipulationMode值，才能成為操作事件來源。 ManipulationMode的預設值是System，可讓內建控制項邏輯處理操作，但不允許應用程式程式碼處理操作事件。 如果您想要處理操作，請將 ManipulationMode 設定為 All，或設定為特定的 ManipulationModes 值。 如需詳細資訊，請參閱 ManipulationMode。

ManipulationStarted 是路由事件。 如果事件因為未處理而允許反升至父元素，則即使 ManipulationMode 是 None 或父元素上的 System ，也可以處理父元素上的事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

對於觸控動作以及因為觸控動作而引發的互動特定或操作事件，元素必須具有點擊測試可見性，才能成為事件來源並引發與動作相關聯的事件。 UIElement.Visibility 必須是 可見的。 衍生型別的其他屬性也會影響點擊測試可見度。 如需詳細資訊，請參閱事件與路由事件概觀。

ManipulationStarted 支援將事件處理常式附加至將叫用的路由，即使事件的事件資料標示為 Handled 也一樣。 請參閱 AddHandler。

適用於

另請參閱