UIElement.DoubleTapped イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素のヒット テスト領域で、それ以外の場合にハンドルされない DoubleTap 操作が発生したときに発生します。
public:
virtual event DoubleTappedEventHandler ^ DoubleTapped;
// Register
event_token DoubleTapped(DoubleTappedEventHandler const& handler) const;
// Revoke with event_token
void DoubleTapped(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DoubleTapped_revoker DoubleTapped(auto_revoke_t, DoubleTappedEventHandler const& handler) const;
public event DoubleTappedEventHandler DoubleTapped;
function onDoubleTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("doubletapped", onDoubleTapped);
uIElement.removeEventListener("doubletapped", onDoubleTapped);
- or -
uIElement.ondoubletapped = onDoubleTapped;
Public Custom Event DoubleTapped As DoubleTappedEventHandler
<uiElement DoubleTapped="eventhandler"/>
イベントの種類
注釈
DoubleTap 操作は、連続して発生する単なる 2 つのタップ操作です。 システムがダブルタップと解釈する正確なタイミングは、システム設定を通じてユーザーが調整可能です。
アプリ の設計 で DoubleTap 操作を使用する方法の詳細については、「タッチ操作の設計」を参照してください。
ユーザーの操作も DoubleTapped発生した場合、 Tapped は最初のタップを表すために最初に起動しますが、2 番目のタップでは追加の Tappedは発生しません。
TappedとDoubleTappedに異なるロジックが必要な場合は、最終的に DoubleTap アクションとして解釈される対話で実行されないように、Tapped ハンドラーでアプリ固有の変数とタイマーを使用する必要があります。
DoubleTapped イベントはジェスチャを表しますが、PointerPressed イベントは下位レベルの入力イベントです。
DoubleTapped および PointerPressed イベントは、単一のユーザー操作の結果として発生する可能性があります。 コントロールが既にコントロール ロジックでポインター イベントを処理している場合や操作を処理している場合でも、 DoubleTapped が発生するのを防ぐことはありません。
DoubleTapped イベントは、複数のポインター ポイントの結果である可能性があります。
DoubleTappedなどの上位レベルのジェスチャ イベントでは、個々の PointerId 値や個々の座標などの PointerPoint の詳細にすぐにアクセスできなくなります。 デバイスの種類 (PointerDeviceType) にアクセスでき、座標の場合は GetPosition を呼び出すことができます。 GetPosition を呼び出すと、複数のポインター ポイントから DoubleTap の座標の平均が得られます。
DoubleTapped はルーティング イベントです。 また、DoubleTappedイベント ソースにするには、要素に IsDoubleTapEnabled をtrueする必要があります (既定では true)。
IsDoubleTapEnabledが親要素でfalseされている場合でも、親要素のDoubleTappedを処理できます。イベントがfalseIsDoubleTapEnabledされているイベント ソースの子要素から親にバブルが発生した場合です。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タッチ アクションの場合や、タッチ アクションの結果となる操作固有のイベントや操作イベントの場合、イベント ソースとしてアクションに関連付けられているイベントを発生させるには、要素をヒット テストで表示する必要があります。 UIElement.Visibility は Visible である必要があります。 派生型の他のプロパティも、ヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
DoubleTapped では、イベントのイベント データが Handled とマークされている場合でも呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。
AddHandler を参照してください。
特定のWindows ランタイム コントロールには、DoubleTapped入力イベントに対するクラスベースの処理が含まれる場合があります。 その場合、コントロールには OnDoubleTapped メソッドのオーバーライドがある可能性があります。 通常、イベントはクラス ハンドラーによって処理済みとしてマークされ、 DoubleTapped イベントは、そのコントロールのユーザー コード ハンドラーによる処理のために発生しません。 イベントのクラス ベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。