语言

UIElement.PointerPressed 活动

定义

当指针设备在此元素中启动 Press 操作时发生。

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"/>

事件类型

注解

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

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

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

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

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

对于触控操作以及特定于交互或操作的事件,元素必须在命中测试中可见才能成为事件源,并触发与操作关联的事件。 UIElement.Visibility 必须是 可见的。 派生类型的其他属性也会影响命中测试可见性。 有关详细信息,请参阅 事件和路由事件概述。

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

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

控件可能还有一个 PointerDownThemeAnimation 个性动画,该动画独立于事件运行。

指针捕获

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

PointerPressed 和手势事件或操作事件

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

触发时 PointerPressed , 点击 等手势事件尚未触发,因为 保留 以外的手势事件正在等待指针在触发事件之前释放。

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

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

PointerPressed 和 PointerReleased

其他事件(而不是 PointerReleased )可能会在操作结束时触发,例如 PointerCanceled 或 PointerCaptureLost。 不要依赖 PointerPressed 事件, PointerReleased 并且事件始终成对发生。 若要正常运行,你的应用必须侦听并处理表示 对 Press 操作可能结论的所有事件。 出现次数的原因之一 PointerReleased 是:

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

适用于

另请参阅