UIElement.Tapped イベント

  • リファレンス

定義

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

この要素のヒット テスト領域で、それ以外の場合はハンドルされない 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"/>

イベントの種類

TappedEventHandler

注釈

タッチ、マウス デバイス、ペン デバイスはすべて 、タップ アクションを生成できます。 詳細については、「 ポインター入力を処理する」を参照してください。

アプリ デザインでタップ操作 を使用する方法の詳細については、「 タッチ 操作の設計」を参照してください。 一般的な考え方は、要素に対する Tap 操作によって、アプリで要素のプライマリ アクションが呼び出されるということです。

イベントは Tapped ジェスチャを表し、 PointerPressed イベントは下位レベルの入力イベントです。 Tapped および PointerPressed イベントは、1 人のユーザー操作の結果として発生する可能性があります。 イベント ソースに既定以外の ManipulationMode がある場合は、 ManipulationStarting も発生させることができます。 コントロールが既にコントロール ロジックで処理 PointerPressed されている場合や操作を処理している場合でも、それが発生するのを防ぐ Tapped わけではありません。

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

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

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

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

特定のWindows ランタイム コントロールには、イベントに対するクラスベースのTapped処理も含まれる場合があります。 その場合、コントロールには OnTapped メソッドのオーバーライドが含まれている可能性があります。 イベントのクラスベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。

Tappedと Holding は相互に排他的です。 入力システムは、アクションTappedHoldingを にするか、他のジェスチャにするかを判断するために、ポインター ポイントが解放されるまで待機する必要があります。そのため、ユーザーが画面に触れた瞬間には表示Tappedされません。 本当にインスタントフィードバックが必要な場合は、代わりに PointerPressed を使用することをお望みかもしれません。

ユーザーの操作でも DoubleTapped が発生した場合、 Tapped 最初のタップを表すために最初にが発生しますが、2 番目のタップでは 追加 Tappedの が発生しません。 に対してDoubleTappedTapped異なるロジックTappedが必要な場合は、最終的に DoubleTap アクションとして解釈される対話で実行されないように、ハンドラーでアプリ固有の変数とタイマーを使用する必要がある場合があります。

マウスとペン/スタイラス入力用にタップ

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

ペン デバイスの場合、ペン デバイスを表面にタッチし、1 か所に残っている場合は 、[保留] アクションが生成されます。

Tapped イベントを発生させないコントロール

これらのコントロールでは、イベントは Tapped 発生しません。

適用対象

こちらもご覧ください