ジェスチャー検出機能

API レベル XE12 で追加されました

タッチパッドのタッチ操作を認識するように最適化されたジェスチャー検出機能。

個別のジェスチャー リスナー(例:GestureDetector.BaseListenerGestureDetector.FingerListener など)と、連続ジェスチャー リスナー(GestureDetector.ScrollListenerGestureDetector.OneFingerScrollListenerGestureDetector.TwoFingerScrollListener)。

詳細については、タップ操作のデベロッパー ガイドをご覧ください。

一般的な使用方法

  1. 必要なリスナー インターフェースを実装し、GestureDetector で設定します。
  2. onGenericMotionEvent(MotionEvent)dispatchGenericFocusedEvent(MotionEvent) などの入力イベント コールバックをオーバーライドし、MotionEvent を操作検出機能の onMotionEvent(MotionEvent) メソッドに渡して、イベントを処理します。
  3. ジェスチャー検出リスナーでイベントを適切に処理します。

    注: リスナーに onXXX メソッドを実装する場合、入力ディスパッチ パイプライン内の他のリスニング エンティティに MotionEvent をディスパッチしない場合にのみ、戻り値を true に設定します。

ネストされたクラス
interface GestureDetector.BaseListener 検出結果を受け取ります。
interface GestureDetector.FingerListener このリスナーは、タッチパッドで検出された指数の変化を報告します。
interface GestureDetector.OneFingerScrollListener このリスナーは、連続 1 本指の水平スクロール イベントを受け取ります。
interface GestureDetector.ScrollListener このリスナーは、指の数とは関係なく、連続する水平スクロール イベントを受け取ります。
interface GestureDetector.TwoFingerScrollListener このリスナーは、連続する 2 本指の水平スクロール イベントを受け取ります。
パブリック コンストラクタ
GestureDetectorContext コンテキスト)
パブリック メソッド
静的 ブール値
静的 ブール値
isForward(float deltaX)
ブール値
onMotionEventMotionEvent イベント)
GestureDetector
setAlwaysConsumeEvents(ブール値有効)
GestureDetector
GestureDetector
GestureDetector
GestureDetector
GestureDetector
継承されるメソッド

パブリック コンストラクタ

API レベル XE12 で追加

public GestureDetector Context context)

パブリック メソッド

API レベル XE16 で追加

public static boolean isForward ジェスチャー操作)

指定された操作がタッチパッド上の前方動作に対応している場合に true を返します。

このメソッドは、横方向のスワイプに対してのみ有効で、他の操作で呼び出された場合は例外をスローします。

API レベル XE16 で追加

public static boolean isForward (float deltaX)

指定された変位がタッチパッド上の前方移動に対応する場合に true を返します。

API レベル XE12 で追加

public boolean onMotionEvent MotionEvent イベント)

モーション イベントを処理し、イベントを常に消費する必要がある場合、または操作が検出された場合は true を返します。

戻り値
  • タッチイベントが消費されるかどうかを反映します。
API レベル XE12 で追加

public GestureDetector setAlwaysConsumeEvents (boolean enabled)

実際に処理されたかどうかにかかわらず、onMotionEvent(MotionEvent) に渡されたイベントをジェスチャー検出機能で使用するかどうかを設定します。

API レベル XE12 で追加

public GestureDetector setBaseListener (GestureDetector.BaseListenerリスナー)

基本操作リスナーを設定します。

API レベル XE12 で追加

public GestureDetector setFingerListener GestureDetector.FingerListenerリスナー)

フィンガー リスナーを設定します。

API レベル XE21 で追加

public GestureDetector setOneFingerScrollListener GestureDetector.OneFingerScrollListenerリスナー)

水平スクロールと 1 本指のスクロールを検出するリスナーを設定します。

API レベル XE12 で追加

public GestureDetector setScrollListener (GestureDetector.ScrollListenerリスナー)

指の数とは無関係に水平スクロールを検出するリスナーを設定します。

API レベル XE12 で追加

public GestureDetector setTwoFingerScrollListener GestureDetector.TwoFingerScrollListenerリスナー)

水平スクロールと 2 本指のスクロールを検出するリスナーを設定します。