Android GestureDetector方法详解

为了加强点击、拖动响应事件，Android提供了GestureDetector手势识别类。通过GestureDetector.OnGestureListener来获取当前被触发的操作手势（Single Tap Up、Show Press、Long Press、Scroll、Down、Fling），具体包括以下几种：

1. boolean  onDoubleTap(MotionEvent e)

解释：双击的第二下down时触发

1. boolean  onDoubleTapEvent(MotionEvent e)

解释：双击的第二下down和up都会触发，可用e.getAction()区分。

1. boolean  onDown(MotionEvent e)

解释：down时触发

1. boolean  onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY)

解释：Touch了滑动一点距离后，up时触发。

1. void  onLongPress(MotionEvent e)

解释：Touch了不移动一直down时触发

1. boolean  onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY)

解释：Touch了滑动时触发。

1. void  onShowPress(MotionEvent e)

解释：Touch了还没有滑动时触发

与onDown，onLongPress比较 onDown只要Touch down一定立刻触发。 
而Touch down后过一会没有滑动先触发onShowPress再是onLongPress。
所以Touch down后一直不滑动，onDown->onShowPress->onLongPress这个顺序触发。

boolean  onSingleTapConfirmed(MotionEvent e) 
boolean  onSingleTapUp(MotionEvent e) 
解释：上面这两个函数都是在touch down后又没有滑动（onScroll），又没有长按（onLongPress），然后Touchup时触发。

点击一下非常快的（不滑动）Touchup： 
onDown->onSingleTapUp->onSingleTapConfirmed 
点击一下稍微慢点的（不滑动）Touchup： 
onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed

创建手势监听对象：

1. package com.sun.gesturetest;
2. import android.util.Log;
3. import android.view.GestureDetector.SimpleOnGestureListener;
4. import android.view.MotionEvent;
5. public class MyGestureListener extends SimpleOnGestureListener {
6. private static final String TAG = "MyGestureListener";
7. public MyGestureListener() {
8. }
9. /**
10. * 双击的第二下Touch down时触发
11. * @param e
12. * @return
13. */
14. @Override
15. public boolean onDoubleTap(MotionEvent e) {
16. Log.i(TAG, "onDoubleTap : " + e.getAction());
17. return super.onDoubleTap(e);
18. }
19. /**
20. * 双击的第二下 down和up都会触发，可用e.getAction()区分。
21. * @param e
22. * @return
23. */
24. @Override
25. public boolean onDoubleTapEvent(MotionEvent e) {
26. Log.i(TAG, "onDoubleTapEvent : " + e.getAction());
27. return super.onDoubleTapEvent(e);
28. }
29. /**
30. * down时触发
31. * @param e
32. * @return
33. */
34. @Override
35. public boolean onDown(MotionEvent e) {
36. Log.i(TAG, "onDown : " + e.getAction());
37. return super.onDown(e);
38. }
39. /**
40. * Touch了滑动一点距离后，up时触发。
41. * @param e1
42. * @param e2
43. * @param velocityX
44. * @param velocityY
45. * @return
46. */
47. @Override
48. public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
49. float velocityY) {
50. Log.i(TAG, "onFling e1 : " + e1.getAction() + ", e2 : " + e2.getAction() + ", distanceX : " + velocityX + ", distanceY : " + velocityY);
51. return super.onFling(e1, e2, velocityX, velocityY);
52. }
53. /**
54. * Touch了不移动一直 down时触发
55. * @param e
56. */
57. @Override
58. public void onLongPress(MotionEvent e) {
59. Log.i(TAG, "onLongPress : " + e.getAction());
60. super.onLongPress(e);
61. }
62. /**
63. * Touch了滑动时触发。
64. * @param e1
65. * @param e2
66. * @param distanceX
67. * @param distanceY
68. * @return
69. */
70. @Override
71. public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX,
72. float distanceY) {
73. Log.i(TAG, "onScroll e1 : " + e1.getAction() + ", e2 : " + e2.getAction() + ", distanceX : " + distanceX + ", distanceY : " + distanceY);
74. return super.onScroll(e1, e2, distanceX, distanceY);
75. }
76. /**
77. * Touch了还没有滑动时触发
78. * @param e
79. */
80. @Override
81. public void onShowPress(MotionEvent e) {
82. Log.i(TAG, "onShowPress : " + e.getAction());
83. super.onShowPress(e);
84. }
85. @Override
86. public boolean onSingleTapConfirmed(MotionEvent e) {
87. Log.i(TAG, "onSingleTapConfirmed : " + e.getAction());
88. return super.onSingleTapConfirmed(e);
89. }
90. @Override
91. public boolean onSingleTapUp(MotionEvent e) {
92. Log.i(TAG, "onSingleTapUp : " + e.getAction());
93. return super.onSingleTapUp(e);
94. }
95. }

在Activity中onTouchEvent(MotionEvent event)方法中设置手势：

1. package com.sun.gesturetest;
2. import android.os.Bundle;
3. import android.app.Activity;
4. import android.view.GestureDetector;
5. import android.view.Menu;
6. import android.view.MotionEvent;
7. public class MainActivity extends Activity {
8. private GestureDetector mDetector;
9. @Override
10. public void onCreate(Bundle savedInstanceState) {
11. super.onCreate(savedInstanceState);
12. setContentView(R.layout.activity_main);
13. mDetector = new GestureDetector(this, new MyGestureListener());
14. }
15. @Override
16. public boolean onTouchEvent(MotionEvent event) {
17. return mDetector.onTouchEvent(event);
18. }
19. @Override
20. public boolean onCreateOptionsMenu(Menu menu) {
21. getMenuInflater().inflate(R.menu.activity_main, menu);
22. return true;
23. }
24. }

或者在自定义View中设置手势：

1. package com.sun.gesturetest;
2. import android.content.Context;
3. import android.util.AttributeSet;
4. import android.view.GestureDetector;
5. import android.view.MotionEvent;
6. import android.view.View;
7. public class GestureView extends View {
8. private GestureDetector mDetector;
9. public GestureView(Context context, AttributeSet set) {
10. super(context, set);
11. mDetector = new GestureDetector(context, new MyGestureListener());
12. setLongClickable(true);
13. this.setOnTouchListener(new OnTouchListener() {
14. @Override
15. public boolean onTouch(View v, MotionEvent event) {
16. return mDetector.onTouchEvent(event);
17. }
18. });
19. }
20. }

在View中设置手势有两点需要注意：

1：View必须设置longClickable为true，否则手势识别无法正确工作，只会返回Down, Show, Long三种手势。

2：必须在View的onTouchListener中调用手势识别，而不能像Activity一样重载onTouchEvent，否则同样手势识别无法正确工作。