Language

UIElement.PointerReleased イベント

定義

この要素内で、以前に 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"/>

イベントの種類

注釈

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

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

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

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

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

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

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

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

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

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

適用対象

こちらもご覧ください