共用方式為

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 出現的一些原因如下：

  • 變更顯示區域關聯性的使用者動作，例如變更解析度或監視設定
  • 輸入互動，例如觸控與先前觸控動作相同表面的手寫筆
  • 使用者登出或類似非應用程式特定中斷
  • 同時連絡人的數目超過裝置所支援的數目

重要

PointerCanceled 可能會引發 ，而不是 PointerReleased。 請勿依賴 PointerPressed ，而且 PointerReleased 事件一律以配對方式發生。 若要正常運作，您的應用程式必須接聽並處理代表 按下 動作可能結論的所有事件，且包括 PointerCanceled 。

如果 PointerCanceled 引發，則會釋放該指標的任何指標擷取。 如需指標擷取的詳細資訊，請參閱 CapturePointer。

處理 PointerCanceled 事件時，預期您透過處理常式取得的 PointerRoutedEventArgs 物件中，某些通常可用於指標事件的事件資料不會有意義。 例如，指標的 Microsoft.UI.Input.PointerPoint.Position 無效，因為指標已不存在。

PointerCanceled 是路由事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

PointerCanceled 支援將事件處理常式附加至將叫用的路由的能力，即使事件的事件資料標示為 Handled也一樣。 請參閱 AddHandler。

適用於

另請參閱