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 が発生する理由の一部を次に示します。

  • 解像度やモニターの設定の変更など、表示領域の関係を変更するユーザー アクション
  • 前のタッチ アクションと同じサーフェスに触れるスタイラスなどの入力操作
  • ユーザーが、アプリ固有ではないログオフまたは同様の中断を行う
  • 同時連絡先の数が、デバイスでサポートされている数を超えました

重要

PointerCanceledPointerReleased の代わりに が発生する可能性があります。 PointerPressed とPointerReleasedイベントが常にペアで発生することに依存しないでください。 アプリが適切に機能するには、 Press アクションに対して考えられる結論を表し、 を含むすべての PointerCanceledイベントをリッスンして処理する必要があります。

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

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

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

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

適用対象

こちらもご覧ください