言語

UIElement.RightTapped イベント

定義

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

ポインターが要素の上にある間に右タップ入力刺激が発生したときに発生します。

public:
 virtual event RightTappedEventHandler ^ RightTapped;
// Register
event_token RightTapped(RightTappedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::RightTapped_revoker RightTapped(auto_revoke_t, RightTappedEventHandler const& handler) const;
public event RightTappedEventHandler RightTapped;
function onRightTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("righttapped", onRightTapped);
uIElement.removeEventListener("righttapped", onRightTapped);
- or -
uIElement.onrighttapped = onRightTapped;
Public Custom Event RightTapped As RightTappedEventHandler 
<uielement RightTapped = "eventhandler" .../>

イベントの種類

RightTappedEventHandler

注釈

RightTapped タッチ アクションの場合は、一定の時間 1 か所に残っているアクションを処理した結果が得られます。 タッチ アクションの場合、常に同じ要素からの Holding イベントがこれに先行しますが、 RightTapped タッチ ポイントが解放されるまで発生しません。 ポインターが押された時間が短すぎて、Holdingの代わりにタップが発生する場合、または Hold アクションが HoldState で [キャンセル] で終了した場合、RightTappedは起動しません。

RightTapped は、コンテキスト メニューを表示するために処理するイベントです。 アプリ 設計 で右タップ操作を使用する方法の詳細については、 カスタム ユーザー操作 のタッチ操作設計と UX ガイドラインを参照してください。

RightTapped イベントはジェスチャを表しますが、PointerReleased イベントは下位レベルの入力イベントです。 RightTapped および PointerReleased イベントは、単一のユーザー操作の結果として発生する可能性があります。 コントロールが既にコントロール ロジックでポインター イベントを処理している場合や操作を処理している場合でも、 RightTapped が発生するのを防ぐことはありません。

RightTapped イベントは、複数のポインター ポイントの結果である可能性があります。 RightTappedなどの上位レベルのジェスチャ イベントでは、個々の PointerId 値や個々の座標などの PointerPoint の詳細にすぐにアクセスできなくなります。 デバイスの種類 (PointerDeviceType) にアクセスでき、座標の場合は GetPosition を呼び出すことができます。 GetPosition を呼び出すと、複数のポインター ポイントから RightTap の座標の平均が得られます。

RightTapped はルーティング イベントです。 また、RightTappedイベント ソースにするには、要素に IsRightTapEnabled をtrueする必要があります (trueが既定です)。 IsRightTapEnabledが親要素でfalseされている場合でも、親要素のRightTappedを処理できます。イベントがfalseIsRightTapEnabledされているイベント ソースの子要素から親にバブルが発生した場合です。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

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

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

特定のWindows ランタイム コントロールには、RightTapped イベントに対するクラスベースの処理が含まれる場合があります。 その場合、コントロールには OnRightTapped メソッドのオーバーライドがある可能性があります。 右タップ アクションは、コンテキスト メニューまたはセカンダリ ウィンドウの表示に関連付けられている場合があります。 イベントのクラス ベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。

マウスとペン/スタイラス入力用の RightTapped

入力システムは、ユーザーが要素の上でマウスの右ボタンをクリックするアクションを RightTapped アクションとして処理します。 このイベントは、マウスの右ボタンが離されるまで発生しません。 マウス入力では、マウス ボタンが押されている時間や保持されているボタンに関係なく、既定では 保留イベントは 生成されません。

一部のペン デバイスには複数のボタンがあり、そのうちの 1 つはマウス デバイスの右ボタンを使用するのと同じ方法で使用できます。 これはデバイスとその設定によって異なりますが、ペン デバイスで同等の右クリックが有効になっている場合、入力システムはこれらのアクションに対して RightTapped 起動することもできます。

適用対象

こちらもご覧ください