共用方式為


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

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

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

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

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

適用於

另請參閱