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 イベントが常にペアで発生することに依存しないでください。 アプリが正常に機能するには、 Press アクションに対して考えられる結論を表し、 PointerCanceledを含むすべてのイベントをリッスンして処理する必要があります。

PointerCanceled発生すると、そのポインターによってキャプチャされたポインターが解放されます。 ポインター キャプチャの詳細については、「 CapturePointer」を参照してください。

PointerCanceled イベントを処理する場合は、ポインター イベントに対して通常使用できるイベント データの一部が、ハンドラーを介して取得する PointerRoutedEventArgs オブジェクトでは意味を持たない可能性があります。 たとえば、Microsoft。Ui。ポインターが存在しなくなったため、ポインターの Input.PointerPoint.Position が無効です。

PointerCanceled はルーティング イベントです。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

PointerCanceled では、イベントのイベント データが Handled とマークされている場合でも呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。 AddHandler を参照してください。

適用対象

こちらもご覧ください