「タッチイベントを取得する(onTouchEventとMotionEvent)」でも紹介したように
タッチパネルのシングルタップや座標の取得はonTouchEventとMotionEventを利用することで
実現することができます。しかし、ダブルタップや長押しのように少し複雑なタッチイベントは
onTouchEventとMotionEventだけでは取得できません。

今回紹介するGestureDetectorクラスではダブルタップや長押しのような複雑なタッチイベントを簡単に取得するためのインタフェースやメソッドを提供しています。

詳しい説明はつづきからどうぞ。

gestureDetector#onTouchEvent

ダブルタップや長押しなどのタッチイベントはgestureDetector#onTouchEventによって判別され、
タッチイベントの種類によって後述するGestureDetector.OnGestureListenerと
GestureDetector.OnDoubleTapListenerのメソッドに振り分けられます。

// GestureDetectorインスタンス変数
GestureDetector gestureDetector;

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

    // GestureDetectorインスタンス作成
    gestureDetector = new GestureDetector(this, this);
}

@Override
public boolean onTouchEvent(MotionEvent ev) {
	// gestureDetector#onTouchEventメソッドでタッチイベントの判別・振り分けを行う
	gestureDetector.onTouchEvent(ev);

    return false;
}

GestureDetector.OnGestureListenerとGestureDetector.OnDoubleTapListener

GestureDetector#onTouchEventで振り分けられたタッチイベントを処理するために、
GestureDetector.OnGestureListenerとGestureDetector.OnDoubleTapListenerの
2つのインタフェースを実装します。

GestureDetector.OnGestureListener

GestureDetector.OnGestureListenerで用意されているメソッドには以下のようなものがあります。

• boolean onDown(MotionEvent e)

　画面を押したときに呼び出される。

• boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY)

　画面にはじいたときに呼び出される。

• void onLongPress(MotionEvent e)

　画面を長押ししたときに呼び出される。

• boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY)

　画面をドラッグしたときに呼び出される。

• void onShowPress(MotionEvent e)

　画面を押したときに呼び出される。ただし、画面を押してすぐにドラッグしたり画面を離した場合は呼び出されない。

• boolean onSingleTapUp(MotionEvent e)

　画面をシングルタップしたときに呼び出される。なお、ダブルタップのときにも呼び出される。

GestureDetector.OnDoubleTapListener

続いてGestureDetector.OnDoubleTapListenerで用意されているメソッドには以下のようなものがあります。

• boolean onDoubleTap(MotionEvent e)

　画面をダブルタップしたときに呼び出される。

• boolean onDoubleTapEvent(MotionEvent e)

　画面のダブルタップ中のイベント（押す、スクロール、離す）で呼び出される。

• boolean onSingleTapConfirmed(MotionEvent e)

　画面をシングルタップしたときに呼び出される。なお、ダブルタップのときには呼び出されない。

サンプルコード

上記のメソッドを実装したサンプルコードです。
呼び出されるタイミングが分かるように各メソッドでToastを表示させるようにしています。

public boolean onDown(MotionEvent e) {
	Toast.makeText(this, "called onDown()", Toast.LENGTH_LONG).show();
	return false;
}

public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
		float velocityY) {
	Toast.makeText(this, "called onFling()", Toast.LENGTH_LONG).show();
	return false;
}

public void onLongPress(MotionEvent e) {
	Toast.makeText(this, "called onLongPress()", Toast.LENGTH_LONG).show();

}

public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX,
		float distanceY) {
	Toast.makeText(this, "called onScroll()", Toast.LENGTH_LONG).show();
	return false;
}

public void onShowPress(MotionEvent e) {
	Toast.makeText(this, "called onShowPress()", Toast.LENGTH_LONG).show();

}

public boolean onSingleTapUp(MotionEvent e) {
	Toast.makeText(this, "called onSingleTapUp()", Toast.LENGTH_LONG).show();
	return false;
}

public boolean onDoubleTap(MotionEvent e) {
	Toast.makeText(this, "called onDoubleTap()", Toast.LENGTH_LONG).show();
	return false;
}

public boolean onDoubleTapEvent(MotionEvent e) {
	Toast.makeText(this, "called onDoubleTapEvent()", Toast.LENGTH_LONG).show();
	return false;
}

public boolean onSingleTapConfirmed(MotionEvent e) {
	Toast.makeText(this, "called onSingleTapConfirmed()", Toast.LENGTH_LONG).show();
	return false;
}