UIElement.ManipulationCompleted 事件

定義

發生于 UIElement 上的操作完成時。

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

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

ManipulationCompleted 是路由事件。 如果允許事件反升至父元素,因為它未處理,則即使 ManipulationModeNone 或父元素上的 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 的行為。

適用於

另請參閱