UIElement.PointerPressed 事件

  • 参考

定义

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

当指针设备在此元素中启动 “按下” 操作时发生。

public:
 virtual event PointerEventHandler ^ PointerPressed;
// Register
event_token PointerPressed(PointerEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::PointerPressed_revoker PointerPressed(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerPressed;
function onPointerPressed(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerpressed", onPointerPressed);
uIElement.removeEventListener("pointerpressed", onPointerPressed);
- or -
uIElement.onpointerpressed = onPointerPressed;
Public Custom Event PointerPressed As PointerEventHandler 
<uiElement PointerPressed="eventhandler"/>

事件类型

PointerEventHandler

注解

触摸、鼠标和笔/触笔交互在应用中作为指针输入进行接收、处理和管理。 这些交互中的任何一个都可以生成事件 PointerPressed 。 有关详细信息，请参阅 处理指针输入。 指针事件适用于对多个指针及其关系感兴趣的场景，或者检查每个指针的详细信息（例如确切坐标位置）。 否则，可以考虑处理手势事件，例如 点击。

使用基于 PointerEventHandler 的处理程序来处理此事件。

鼠标输入与第一次检测到鼠标输入时分配的单个指针相关联。 单击鼠标按钮 (向左、滚轮或向右) 会通过 PointerPressed 事件在指针与该按钮之间创建辅助关联。 仅当释放该鼠标按钮时才引发 PointerReleased 事件（在完成该事件之前，其他按钮无法与指针关联）。 由于此排他性关联，会通过 PointerMoved 事件路由其他鼠标按钮单击。 处理此事件时，可以测试鼠标按钮状态，如以下示例所示。

鼠标输入设备的指针事件在应用生存期的事件详细信息中通常具有相同的 PointerId 。

PointerPressed 是路由事件。 有关路由事件概念的详细信息，请参阅 事件和路由事件概述。

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

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

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

控件还可以具有独立于事件运行的 PointerDownThemeAnimation 个性动画。

指针捕获

PointerPressed 有时在捕获指针时用作启动事件，以便只要指针保持关闭状态，其他与指针相关的事件都会由特定元素捕获。 若要捕获指针，请在应维护捕获的特定 UI 元素上调用 CapturePointer 方法。 这通常在事件处理程序中PointerPressed完成，并且你对事件的 sender调用CapturePointer。 有关如何捕获指针以及为何要捕获指针的详细信息，请参阅 CapturePointer。

PointerPressed 和笔势事件或操作事件

除非输入设备是鼠标，否则最初触发 PointerPressed 事件的用户操作最终可能会导致“ 保留 ”事件，表示 “保留 ”手势。 如果发生的元素 PointerPressed 具有非默认 ManipulationMode 值，则该操作还可能导致各种操作事件，如 ManipulationStarted。 有关详细信息，请参阅 处理指针输入中的“使用操作事件”部分。

触发时 PointerPressed ，手势事件（如 点击） 尚未触发，因为 除“保持” 以外的手势事件正在等待指针释放，然后再触发事件。

作为应用用户交互的一般设计规则，应检查是否存在可用于交互的特定于控件的事件或适当的手势事件。 例如，如果控件是 Button，则该控件具有一个 Click 事件，该事件专门用于用户调用按钮的操作。 或者，如果元素不是按钮，但你正在处理元素的主操作和事件，则可以处理 点击。

可以通过设置 IsTapEnabled 等属性，在单个元素上专门禁用手势事件。 如果正在处理操作，则可以禁用手势事件，但如果正在处理指针事件，则通常不需要禁用手势事件。 不能专门禁用指针事件，但可以选择不处理它们。

PointerPressed 和 PointerReleased

其他事件（而不是 PointerReleased ）可能会在操作结束时触发，例如 PointerCanceled 或 PointerCaptureLost。 不要依赖 PointerPressed 和 PointerReleased 事件始终成对发生。 若要正常运行，你的应用必须侦听并处理代表 “按下” 操作可能的结论的所有事件。 可能无法出现 PointerReleased 某些原因包括：

  • 特定硬件处理触摸操作和 按下 操作的方式的差异
  • 从其他指针捕获编程指针
  • 更改显示区域关系的用户操作，例如更改分辨率或监视器设置
  • 输入交互，例如触笔，触摸上一个触摸操作的同一表面

适用于

另请参阅