Android GestureDetector方法详解

Posted 2020-08-06 新感觉

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

 

Java代码  

1. boolean  onDoubleTap(MotionEvent e)   

 

 

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

Java代码  

1. boolean  onDoubleTapEvent(MotionEvent e)   

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

Java代码  

1. boolean  onDown(MotionEvent e)   

解释：down时触发 

Java代码  

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

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

Java代码  

1. void  onLongPress(MotionEvent e)   

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

Java代码  

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

 解释：Touch了滑动时触发。 

Java代码  

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

 

创建手势监听对象：

Java代码  

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

 

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

Java代码  

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

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

Java代码  

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

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

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

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