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 も起動した場合、 タップは 最初のタップを表すために最初に起動しますが、2 回目のタップでは追加のタップは発生しません。 Tapped と DoubleTapped の異なるロジックが必要な場合は、最終的に DoubleTap アクションとして解釈される対話で実行されないように、Tapped ハンドラーでアプリ固有の変数とタイマーを使用する必要がある場合があります。
DoubleTapped イベントはジェスチャを表し、 PointerPressed イベントは下位レベルの入力イベントです。 DoubleTapped イベントと PointerPressed イベントは 、1 人のユーザー操作の結果として発生する可能性があります。 コントロールが既にコントロール ロジック内のポインター イベントを処理している場合、または操作を処理している場合でも、DoubleTapped の起動を妨げるわけではありません。
DoubleTapped イベントは、複数のポインター ポイントの結果である可能性があります。 DoubleTapped などの上位レベルのジェスチャ イベントでは、個々の PointerId 値や個々の座標などの PointerPoint の詳細にすぐにアクセスできなくなります。 デバイスの種類 (PointerDeviceType) にアクセスでき、座標の場合は GetPosition を呼び出すことができます。これにより、複数のポインターポイントから DoubleTap の座標の平均が得られます。
DoubleTapped はルーティング イベントです。 また、要素が DoubleTapped イベント ソースになるには 、IsDoubleTapEnabled が true である必要があります (既定値は true です)。 IsDoubleTapEnabled が false の場合でも、親要素で DoubleTapped を処理できます。イベント がイベント ソースの子要素から親にバブルする場合は、IsDoubleTapEnabled が false です。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タッチ操作や、タッチ操作の結果に発生する対話/操作イベントについては、ヒット テストで要素が表示されない場合、イベント ソースとして使用したり、操作に関連付けられたイベントを起動することはできません。 UIElement.Visibility は Visible である必要があります。 派生型の他のプロパティも、ヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
DoubleTapped では、イベントのイベント データが Handled とマークされている場合でも呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。 「 AddHandler」を参照してください。
特定のWindows ランタイム コントロールには、DoubleTapped 入力イベントに対するクラスベースの処理が含まれる場合があります。 その場合、コントロールには OnDoubleTapped メソッドのオーバーライドが含まれている可能性があります。 通常、イベントはクラス ハンドラーによって処理済みとしてマークされ、DoubleTapped イベントは、そのコントロール上のユーザー コード ハンドラーによって処理するために発生しません。 イベントのクラスベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。