UIElement.PointerCanceled 事件

定义

当进行接触的指针异常失去接触时发生。

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

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

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

事件类型

注解

出现 PointerCanceled 的一些原因包括:

  • 更改显示区域关系的用户操作,例如更改分辨率或监视器设置
  • 输入交互,例如触笔,触摸上一个触摸操作的同一表面
  • 用户注销或与应用无关的类似中断
  • 同时联系人数超出了设备支持的数量

重要

PointerCanceled 可能会触发,而不是 PointerReleased。 不要依赖于 PointerPressed ,事件 PointerReleased 始终成对发生。 若要正常运行,你的应用必须侦听并处理所有事件,这些事件代表 Press 操作的可能结论,包括 PointerCanceled

如果 PointerCanceled 触发,则释放该指针捕获的任何指针。 有关指针捕获的详细信息,请参阅 CapturePointer

处理 PointerCanceled 事件时,可以预见一些通常可用于指针事件的事件数据在通过处理程序获取的 PointerRoutedEventArgs 对象中没有意义。 例如,指针的 Microsoft.UI.Input.PointerPoint.Position 无效,因为指针不再存在。

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

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

适用于

另请参阅