UIElement.ManipulationStarted 事件

定义

在输入设备在 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"/>

事件类型

注解

有关自定义控件和交互体验,请参阅 GestureRecognizer.ManipulationStarted

ManipulationStarted 表示操作识别逻辑已检测到指针移动。 在本例中,它是第二个按典型序列触发的操作事件,在 ManipulationStarting 之后、ManipulationDelta 或其他事件(如 ManipulationInertiaStarting)之前触发。

元素必须具有除 NoneSystem 以外的 ManipulationMode 值,才能成为操作事件源。 ManipulationMode 的默认值为 System,它允许内置控制逻辑处理操作,但不允许应用代码处理操作事件。 如果要处理操作,请将 ManipulationMode 设置为 All 或特定的 ManipulationModes 值。 有关详细信息,请参阅 ManipulationMode

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

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

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

适用于

另请参阅