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 イベントは、1 人のユーザー操作の結果として発生させることができます。 イベント ソースに既定以外の ManipulationMode がある場合は、 ManipulationStarting も発生させることができます。 コントロールが既にコントロール ロジックで PointerPressed を処理している場合、または操作を処理している場合でも、Tapped が発生するのを防ぐわけではありません。
Tapped イベントは、複数のポインター ポイントの結果である可能性があります。 タップなどの上位レベルのジェスチャ イベントでは、個々の PointerId 値や個々の座標などの PointerPoint の詳細にすぐにアクセスできなくなります。 デバイスの種類 (PointerDeviceType) にアクセスでき、座標の場合は GetPosition を呼び出すことができます。これにより、複数のポインター ポイントから Tap の座標の平均が得られます。
タップはルーティング イベントです。 また、要素が Tapped イベント ソースになるには 、IsTapEnabled を true にする必要があります (既定値は true です)。 IsTapEnabled が false のイベント ソース子要素から親にイベント がバブルする場合、親要素で IsTapEnabled が false の場合でも、親要素で Tapped を処理できます。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タッチ アクションの場合、およびタッチ アクションの結果である対話式操作固有または操作イベントの場合は、イベント ソースにするには、要素をヒット テストで表示する必要があります。 UIElement.Visibility はVisible である必要があります。 派生型の他のプロパティも、ヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
Tapped では、イベントのイベント データが Handled とマークされている場合でも呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。 「 AddHandler」を参照してください。
特定のWindows ランタイム コントロールには、Tapped イベントのクラスベースの処理が含まれる場合もあります。 その場合、コントロールには OnTapped メソッドのオーバーライドが含まれている可能性があります。 イベントのクラスベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タップと 保持 は相互に排他的です。 入力システムは、ポインター ポイントが解放されるまで待機して、アクションをタップ、 保持 、またはその他のジェスチャにするかどうかを判断する必要があります。そのため、ユーザーが画面に触れた瞬間にタップされることはありません。 あなたが本当にインスタントフィードバックが必要な場合は、代わりに PointerPressed を使用することができます。
ユーザー操作で DoubleTapped も発生した場合、最初のタップを表すために Tapped が最初に発生しますが、2 番目のタップでは追加のタップは発生しません。 Tapped と DoubleTapped の異なるロジックが必要な場合は、最終的に DoubleTap アクションとして解釈される対話で実行されないように、Tapped ハンドラーでアプリ固有の変数とタイマーを使用する必要がある場合があります。
マウスとペン/スタイラスの入力用にタップ
入力システムは、ユーザーが要素の上でタップされたアクションとしてマウスの左ボタンをクリックするアクションを処理します。 このイベントは、マウスの左ボタンが離されるまで発生しません。 マウス入力では、マウス ボタンが押されている時間や保持されているボタンに関係なく、既定では 保留イベントは 生成されません。
ペン デバイスの場合、ペン デバイスを表面に触れ、1 か所に残っている場合、 保留 アクションが生成されます。
Tapped イベントを発生させないコントロール
これらのコントロールでは、 Tapped イベントは発生しません。