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 事件一律以配對方式發生。 若要正常運作，您的應用程式必須接聽並處理代表 Press 動作可能結論的所有事件，並包含 PointerCanceled。

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

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

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

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

適用於

另請參閱