UIElement.Tapped イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素のヒット テスト領域で、それ以外のハンドルされない Tap 操作が発生したときに発生します。
public:
virtual event TappedEventHandler ^ Tapped;// Register
event_token Tapped(TappedEventHandler const& handler) const;
// Revoke with event_token
void Tapped(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Tapped_revoker Tapped(auto_revoke_t, TappedEventHandler const& handler) const;public event TappedEventHandler Tapped;function onTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("tapped", onTapped);
uIElement.removeEventListener("tapped", onTapped);
- or -
uIElement.ontapped = onTapped;Public Custom Event Tapped As TappedEventHandler <uiElement Tapped="eventhandler"/>
イベントの種類
注釈
タッチ、マウス デバイス、ペン デバイスはすべて 、タップ アクションを生成できます。 詳しくは、 ポインター入力の処理に関するページをご覧ください。
アプリ デザイン でタップ操作を使用する方法の詳細については、「 タッチ 操作の設計」を参照してください。 一般的な考え方は、要素に対する Tap 操作によって、アプリで要素の主なアクションが呼び出されるということです。
Tapped イベントはジェスチャを表しますが、PointerPressed イベントは下位レベルの入力イベントです。
Tapped および PointerPressed イベントは、単一のユーザー操作の結果として発生させることができます。 イベント ソースに既定以外の ManipulationMode がある場合は、 ManipulationStarting も発生させることができます。 コントロールが既にコントロール ロジック内の PointerPressed を処理している場合や、操作を処理している場合でも、 Tapped が発生するのを防ぐことはありません。
Tapped イベントは、複数のポインター ポイントの結果である可能性があります。
Tappedなどの上位レベルのジェスチャ イベントでは、個々の PointerId 値や個々の座標などの PointerPoint の詳細にすぐにアクセスできなくなります。 デバイスの種類 (PointerDeviceType) にアクセスでき、座標の場合は GetPosition を呼び出すことができます。 GetPosition を呼び出すと、複数のポインター ポイントから Tap の座標の平均が得られます。
Tapped はルーティング イベントです。 また、Tappedイベント ソースにするには、要素に IsTapEnabled をtrueする必要があります (trueが既定です)。
IsTapEnabledが親要素でfalseされている場合でも、親要素のTappedを処理できます。イベントがfalseIsTapEnabledされているイベント ソースの子要素から親にバブルが発生した場合です。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タッチ アクションの場合や、タッチ アクションの結果となる操作固有のイベントや操作イベントの場合は、イベント ソースにするには、要素をヒット テストで表示する必要があります。 UIElement.Visibility は Visible である必要があります。 派生型の他のプロパティも、ヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
Tapped では、イベントのイベント データが Handled とマークされている場合でも呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。
AddHandler を参照してください。
特定のWindows ランタイム コントロールには、Tapped イベントに対するクラスベースの処理も含まれる場合があります。 その場合、コントロールには OnTapped メソッドのオーバーライドがある可能性があります。 イベントのクラス ベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。
Tapped と ホールディング は相互に排他的です。 入力システムは、アクションが Tapped、 Holding 、またはその他のジェスチャである必要があるかどうかを判断するためにポインター ポイントが解放されるまで待機する必要があるため、ユーザーが画面に触れる瞬間に Tapped されません。 本当にインスタントフィードバックが必要な場合は、代わりに PointerPressed を使用することをお勧めします。
ユーザーの操作で DoubleTapped も発生した場合、最初のタップを表すために Tapped が最初に発生しますが、2 番目のタップでは追加の Tappedは発生しません。
TappedとDoubleTappedに対して異なるロジックが必要な場合は、最終的に DoubleTap アクションとして解釈される対話で実行されないように、Tapped ハンドラーでアプリ固有の変数とタイマーを使用する必要がある場合があります。
マウスとペン/スタイラス入力用にタップ
入力システムは、ユーザーが要素の上でマウスの左ボタンをクリックするアクションを Tapped アクションとして処理します。 このイベントは、マウスの左ボタンが離されるまで発生しません。 マウス入力では、マウス ボタンが押されている時間や保持されているボタンに関係なく、既定では 保留イベントは 生成されません。
ペン デバイスの場合、ペン デバイスを表面に触れ、1 か所に残っている場合は 、保留 アクションが発生します。
Tapped イベントを発生させないコントロール
これらのコントロールでは、 Tapped イベントは発生しません。