Android GestureDetector方法详解

时间：2022-03-22 15:17:11

为了加强点击、拖动响应事件，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，否则同样手势识别无法正确工作。

 

相关文章