UIElement.PointerCanceled 事件

  • 参考

定义

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

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

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

事件类型

PointerEventHandler

注解

出现 PointerCanceled 的一些原因包括：

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

重要

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

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

处理 PointerCanceled 事件时，预计通常可用于指针事件的某些事件数据在通过处理程序获取的 PointerRoutedEventArgs 对象中没有意义。 例如，指针 的位置 无效，因为指针不再存在。

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

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

适用于

另请参阅