UIElement.ManipulationStarted 事件

  • 参考

定义

命名空间:
Microsoft.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但在 或其他事件（如 ）ManipulationInertiaStarting之前ManipulationDelta触发。

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

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

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

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

适用于

另请参阅