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 是路由事件。 如果允许事件因未经处理而向上浮升到父元素,则即使父元素上的 ManipulationModeNoneSystem ,也可以处理父元素上的事件。 有关路由事件概念的详细信息,请参阅 事件和路由事件概述

对于触摸操作以及特定于交互的事件或一个触摸操作引起的操作事件,一个元素必须对点击测试可见,以用作事件源并触发与该操作关联的事件。 UIElement.Visibility 必须为 Visible。 派生类型的其他属性也会影响命中测试可见性。 有关详细信息,请参阅事件和路由事件概述

ManipulationCompleted 支持将事件处理程序附加到将调用的路由,即使事件的事件数据标记为“ 已处理”也是如此。 请参阅 AddHandler

Windows 8 行为

如果惯性阶段已开始 (并且 ManipulationInertiaStarting 已触发) 但用户在完成滚动之前点击了项目,从而直观地取消了惯性阶段,Windows 8 不会触发 ManipulationCompleted。 此问题从 Windows 8.1 开始修复;一旦点击操作取消惯性阶段,就会触发 ManipulationCompleted。

对于针对 Windows 8 编译的应用,如果它在 Windows 8.1 上运行,将继续使用 Windows 8 行为。

适用于

另请参阅