UIElement.DoubleTapped 事件

  • 参考

定义

命名空间:
Windows.UI.Xaml
编辑

在此元素的命中测试区域上发生未经处理的 DoubleTap 交互时发生。

public:
 virtual event DoubleTappedEventHandler ^ DoubleTapped;
// Register
event_token DoubleTapped(DoubleTappedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::DoubleTapped_revoker DoubleTapped(auto_revoke_t, DoubleTappedEventHandler const& handler) const;
public event DoubleTappedEventHandler DoubleTapped;
function onDoubleTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("doubletapped", onDoubleTapped);
uIElement.removeEventListener("doubletapped", onDoubleTapped);
- or -
uIElement.ondoubletapped = onDoubleTapped;
Public Custom Event DoubleTapped As DoubleTappedEventHandler 
<uiElement DoubleTapped="eventhandler"/>

事件类型

DoubleTappedEventHandler

注解

DoubleTap 交互只是快速连续发生的两次点击交互。 系统解释为双击的确切时间可由用户通过系统设置进行调整。

有关如何在应用设计中使用 DoubleTap 交互的详细信息，请参阅触摸交互设计。

如果用户交互也触发了 DoubleTapped， 则点击 将首先触发以表示第一次点击，但第二次点击不会触发其他点击。 如果需要针对 Tap 和 DoubleTapped 使用不同的逻辑， 则 Tappped 处理程序可能需要使用特定于应用的变量和计时器，以避免在最终被解释为 DoubleTap 操作的交互上运行。

DoubleTapped 事件表示手势，而 PointerPressed 事件是较低级别的输入事件。 DoubleTapped 和 PointerPressed 事件可以作为单个用户交互的结果触发。 即使控件已在控制逻辑中处理指针事件或正在处理操作，也不会阻止 DoubleTapped 触发。

DoubleTapped 事件可能是多个指针点的结果。 对于较高级别的手势事件（如 DoubleTapped），你不再能够立即访问 PointerPoint 详细信息，例如单个 PointerId 值或单个坐标。 你确实有权访问设备类型 (PointerDeviceType) ，对于坐标，可以调用 GetPosition，这会提供来自多个指针点的 DoubleTap 坐标的平均值。

DoubleTapped 是路由事件。 此外，元素必须具有 IsDoubleTapEnabled 为 true 才能成为 DoubleTapped 事件源， (true 是默认) 。 即使父元素上的 IsDoubleTapEnabled 为 false ，如果事件从事件源子元素冒泡到父元素（其中 IsDoubleTapEnabled 为 false），也可以处理父元素上的 DoubleTapped。 有关路由事件概念的详细信息，请参阅 事件和路由事件概述。

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

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

对于 DoubleTapped 输入事件，特定Windows 运行时控件可能具有基于类的处理。 如果是这样，控件可能具有 OnDoubleTapped 方法的替代。 通常，事件被标记为由 类处理程序处理，并且不会引发 DoubleTapped 事件，以便由该控件上的任何用户代码处理程序进行处理。 有关事件基于类的处理工作原理的详细信息，请参阅 事件和路由事件概述。

适用于

另请参阅