首页 > 代码库 > Android GestureDetector方法详解

Android GestureDetector方法详解

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

 

 

 

Android GestureDetector方法详解