UIElement.DoubleTapped 事件

  • 参考

定义

命名空间:
Microsoft.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， 则点击 将首先触发以表示第一个点击，但第二个点击不会触发其他 Tapped。 如果希望为 Tapped 和 DoubleTapped使用不同的逻辑，则 Tapped 处理程序可能需要使用特定于应用的变量和计时器，以避免在最终解释为 DoubleTap 操作的交互上运行。

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

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

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

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

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

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

适用于

另请参阅