語言

UIElement.PointerCanceled 事件

定義

命名空間:
Microsoft.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 事件的一些原因包括：

  • 使用者操作改變顯示區域關係，例如更改解析度或螢幕設定
  • 輸入互動，例如觸控筆觸碰與先前觸控動作相同的表面
  • 使用者登出或類似的中斷，但這些中斷並非應用程式專屬
  • 同時接觸的數量超過裝置所支援的數量

Important

PointerCanceled 可能觸發，而不是 PointerReleased。 不要只依賴 PointerPressed 和 PointerReleased 事件總是成對發生。 為了正常運作，你的應用程式必須監聽並處理所有代表 新聞 行動可能結論的事件，其中包括 PointerCanceled。

如果 PointerCanceled 觸發，該指標捕獲的任何指標都會被釋放。 欲了解更多指標捕捉資訊，請參閱 CapturePointer。

處理事件時 PointerCanceled ，預期指標事件通常可用的部分事件資料，可能無法在你透過處理器取得的 PointerRoutedEventArgs 物件中發揮作用。 例如，Microsoft。UI。Input.PointerPoint.Position 的指標無效，因為指標已不存在。

PointerCanceled 是路由事件。 欲了解更多路由事件概念，請參閱 事件與路由事件總覽。

PointerCanceled 支援即使事件資料標記 為已處理，也能將事件處理器附加到將被呼叫的路由上。 請參見 AddHandler。

適用於

另請參閱