UIElement.ManipulationCompleted 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
public:
virtual event ManipulationCompletedEventHandler ^ ManipulationCompleted;
// Register
event_token ManipulationCompleted(ManipulationCompletedEventHandler const& handler) const;
// Revoke with event_token
void ManipulationCompleted(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::ManipulationCompleted_revoker ManipulationCompleted(auto_revoke_t, ManipulationCompletedEventHandler const& handler) const;
public event ManipulationCompletedEventHandler ManipulationCompleted;
function onManipulationCompleted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationcompleted", onManipulationCompleted);
uIElement.removeEventListener("manipulationcompleted", onManipulationCompleted);
- or -
uIElement.onmanipulationcompleted = onManipulationCompleted;
Public Custom Event ManipulationCompleted As ManipulationCompletedEventHandler
<uiElement ManipulationCompleted="eventhandler"/>
事件類型
備註
如需自訂控制項和互動體驗,請參閱 GestureRecognizer.ManipulationCompleted。
元素必須有None或System以外的ManipulationMode值,才能成為操作事件來源。 ManipulationMode的預設值是System,可讓內建控制項邏輯處理操作,但不允許應用程式程式碼處理操作事件。 如果您想要處理操作,請將 ManipulationMode 設定為 All,或設定為特定的 ManipulationModes 值。 如需詳細資訊,請參閱 ManipulationMode。
ManipulationCompleted 是路由事件。 如果允許事件反升至父元素,因為它未處理,則即使 ManipulationMode 為 None 或父元素上的 System ,也可以處理父元素上的事件。 如需路由事件概念的詳細資訊,請參閱 事件和路由事件概觀。
對於觸控動作以及因為觸控動作而引發的互動特定或操作事件,元素必須具有點擊測試可見性,才能成為事件來源並引發與動作相關聯的事件。 UIElement.Visibility 必須是 Visible。 衍生類型的其他屬性也會影響點擊測試可見度。 如需詳細資訊,請參閱事件與路由事件概觀。
ManipulationCompleted 支援將事件處理常式附加至將叫用的路由,即使事件的事件資料標示為 Handled 也一樣。 請參閱 AddHandler。
Windows 8 行為
Windows 8 不會在慣性階段啟動 (且 ManipulationInertiaStarting 已引發) 但使用者已在專案完成捲動之前點選,這會以視覺方式取消慣性階段。Windows 8 不會引發 ManipulationCompleted。 此問題從 Windows 8.1 開始修正;只要點選動作取消慣性階段,就會引發 ManipulationCompleted。
針對 Windows 8 編譯但在 Windows 8.1 上執行的應用程式會繼續使用 Windows 8 的行為。