UIElement.PointerReleased イベント

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml
編集

この要素内で、以前に Press アクションを開始したポインター デバイスが解放されたときに発生します。 Press アクションの終了は、イベントを発生PointerReleasedさせる保証はありません。代わりに他のイベントが発生する可能性があります。 詳細については、「備考」を参照してください。

public:
 virtual event PointerEventHandler ^ PointerReleased;
// Register
event_token PointerReleased(PointerEventHandler const& handler) const;

// Revoke with event_token
void PointerReleased(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerReleased;
function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;
Public Custom Event PointerReleased As PointerEventHandler 
<uiElement PointerReleased="eventhandler"/>

イベントの種類

PointerEventHandler

注釈

タッチ、マウス、ペン/スタイラスの操作は、アプリでポインター入力として受信、処理、管理されます。 これらの操作は、いずれもイベントを PointerReleased 生成できます。 詳細については、「 ポインター入力を処理する」を参照してください。

の代わりに他の PointerReleased イベントがアクションの最後に発生する可能性があります ( PointerCanceled や PointerCaptureLost など)。 PointerPressed とPointerReleasedイベントが常にペアで発生することに依存しないでください。 適切に機能するには、アプリで Press アクションの結論を表す可能性のあるすべてのイベントをリッスンして処理する必要があります。 発生しない理由 PointerReleased の一部を次に示します。

  • 特定のハードウェアがタッチ アクションと プレス アクションを処理する方法の違い
  • 別のポインターからのプログラム ポインター キャプチャ
  • 解像度やモニター設定の変更など、表示領域の関係を変更するユーザー アクション
  • 前のタッチ アクションと同じサーフェスに触れるスタイラスなどの入力操作

イベントを最初に発生 PointerReleased するユーザー アクションは、イベントを Tapped 発生させたり、デバイスごとに異なる条件下で RightTapped 発生したりする可能性もあります。 詳細については、「 タップ」 と「 RightTapped」を参照してください。

マウス入力が最初に検出されると、割り当てられている単一ポインターと関連付けられます。 マウス ボタン (左ボタン、ホイール、または右ボタン) をクリックすると、PointerPressed イベントによってポインターとそのボタンの間に 2 番目の関連付けが行われます。 イベントは PointerReleased 、同じマウス ボタンが離された場合にのみ発生します (このイベントが完了するまで、他のボタンをポインターに関連付けすることはできません)。 この排他的な関連付けのために、他のマウス ボタンをクリックした場合は、PointerMoved イベントによってルーティングされます。 次の例に示すように、このイベントを処理するときにマウス ボタンの状態をテストできます。

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

タッチ操作や、タッチ操作の結果に発生する対話/操作イベントについては、ヒット テストで要素が表示されない場合、イベント ソースとして使用したり、操作に関連付けられたイベントを起動することはできません。 UIElement.Visibility はVisible である必要があります。 派生型の他のプロパティも、ヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。

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

特定のWindows ランタイム コントロールには、入力イベントのクラスベースの処理がPointerReleased含まれる場合があります。 その場合、コントロールには OnPointerReleased メソッドのオーバーライドが含まれている可能性があります。 通常、イベントはクラス ハンドラーによって処理済みとしてマークされ PointerReleased 、そのコントロール上のユーザー コード ハンドラーによる処理ではイベントは発生しません。 イベントのクラスベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。

コントロールには、イベントとは別に実行される PointerUpThemeAnimation パーソナリティ アニメーションを含めることもできます。

適用対象

こちらもご覧ください