UIElement.ManipulationStarting 事件

定义

在首次创建操作处理器时发生。

public:
 virtual event ManipulationStartingEventHandler ^ ManipulationStarting;
// Register
event_token ManipulationStarting(ManipulationStartingEventHandler const& handler) const;

// Revoke with event_token
void ManipulationStarting(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::ManipulationStarting_revoker ManipulationStarting(auto_revoke_t, ManipulationStartingEventHandler const& handler) const;
public event ManipulationStartingEventHandler ManipulationStarting;
function onManipulationStarting(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarting", onManipulationStarting);
uIElement.removeEventListener("manipulationstarting", onManipulationStarting);
- or -
uIElement.onmanipulationstarting = onManipulationStarting;
Public Custom Event ManipulationStarting As ManipulationStartingEventHandler 
<uiElement ManipulationStarting="eventhandler"/>

事件类型

注解

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

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

ManipulationStarting 基本上,每当指针与元素交互(其中元素允许操作)时,都触发。 这包括将操作解释为手势且指针永远不会移动的情况,例如 点击按住 手势。 如果指针确实移动, 则 ManipulationStarted 通常会在此之后触发。

ManipulationStarting 是路由事件。 如果允许事件因未经处理而向上气泡到父元素,则可以处理父元素上的事件,即使 ManipulationModeNone 父元素或 System 父元素上的事件。 有关路由事件概念的详细信息,请参阅 事件和路由事件概述

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

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

适用于

另请参阅