GestureDetector.OnGestureListener 詳解

轉自:http://blog.csdn.net/xiezhenxiang/article/details/6659506

感謝android中國開發者的衆多先驅,本文主要內容來自於總結,一小部分是自己的體會。主要參考文章爲:

 

http://www.williamhua.com/2009/04/23/android-touchscreen-gesture-recogniton/

http://goro.iteye.com/blog/402163

 

Android Touch Screen 與傳統Click Touch Screen不同,會有一些手勢(Gesture),例如Fling,Scroll等等。這些Gesture會使用戶體驗大大提升。Android中的Gesture識別(detector)是通過GestureDetector.OnGestureListener接口實現的。

首先,Android事件處理機制是基於Listener實現的,比如觸摸屏相關的事件,就是通過onTouchListener實現;

其次,所有View的子類都可以通過setOnTouchListener()、setOnKeyListener()等方法來添加對某一類事件的Listener;

第三,Listener一般會以Interface的方式來提供,其中包含一個或多個abstract方法,我們需要實現這些方法來完成onTouch()、onKey()等操作。這樣,程序便可以在特定的事件被dispatch到該view的時候,通過callback函數給予適當的響應。

 

1. Touch Screen Click舉例

Java代碼 複製代碼 收藏代碼
  1. public class MyGesture extends Activity implements OnTouchListener {   
  2.     public void onCreate(Bundle savedInstanceState) {   
  3.         super.onCreate(savedInstanceState);   
  4.         setContentView(R.layout.main);   
  5.         TextView tv = (TextView) findViewById(R.id.tv);   
  6.         tv.setOnTouchListener(this);   
  7.     }   
  8.     public boolean onTouch(View v, MotionEvent event) {   
  9.         Toast.makeText(this"Touch Touch", Toast.LENGTH_SHORT).show();   
  10.         return false;   
  11.     }   
  12. }  
[java] view plaincopy
  1. public class MyGesture extends Activity implements OnTouchListener {  
  2.     public void onCreate(Bundle savedInstanceState) {  
  3.         super.onCreate(savedInstanceState);  
  4.         setContentView(R.layout.main);  
  5.         TextView tv = (TextView) findViewById(R.id.tv);  
  6.         tv.setOnTouchListener(this);  
  7.     }  
  8.     public boolean onTouch(View v, MotionEvent event) {  
  9.         Toast.makeText(this"Touch Touch", Toast.LENGTH_SHORT).show();  
  10.         return false;  
  11.     }  
  12. }  

我們可以通過MotionEvent的getAction()方法來獲取Touch事件的類型,包括 ACTION_DOWN(按下觸摸屏), ACTION_MOVE(按下觸摸屏後移動受力點), ACTION_UP(鬆開觸摸屏)和ACTION_CANCEL(不會由用戶直接觸發)。藉助對於用戶不同操作的判斷,結合getRawX()、getRawY()、getX()和getY()等方法來獲取座標後,我們可以實現諸如拖動某一個按鈕,拖動滾動條等功能。

 

2. 回到今天的重點,當我們捕捉到Touch操作的時候,如何識別出用戶的Gesture?這裏我們需要GestureDetector.OnGestureListener接口的幫助,代碼如下:

Java代碼 複製代碼 收藏代碼
  1. public class MyGesture extends Activity implements OnTouchListener, OnGestureListener {   
  2.     private GestureDetector mGestureDetector;   
  3.     public MyGesture() {   
  4.         mGestureDetector = new GestureDetector(this);   
  5.     }   
  6.     public void onCreate(Bundle savedInstanceState) {   
  7.         super.onCreate(savedInstanceState);   
  8.         setContentView(R.layout.main);   
  9.         TextView tv = (TextView) findViewById(R.id.tv);   
  10.         tv.setOnTouchListener(this);   
  11.         tv.setFocusable(true);   
  12.         tv.setClickable(true);   
  13.         tv.setLongClickable(true);   
  14.         mGestureDetector.setIsLongpressEnabled(true);   
  15.     }   
  16.        
  17.     /*  
  18.      * 在onTouch()方法中,我們調用GestureDetector的onTouchEvent()方法,將捕捉到的MotionEvent交給GestureDetector  
  19.      * 來分析是否有合適的callback函數來處理用戶的手勢  
  20.      */    
  21.     public boolean onTouch(View v, MotionEvent event) {   
  22.         return mGestureDetector.onTouchEvent(event);   
  23.     }   
  24.   
  25.     // 用戶輕觸觸摸屏,由1個MotionEvent ACTION_DOWN觸發   
  26.     public boolean onDown(MotionEvent arg0) {   
  27.         Log.i("MyGesture""onDown");   
  28.         Toast.makeText(this"onDown", Toast.LENGTH_SHORT).show();   
  29.         return true;   
  30.     }   
  31.        
  32.     /*  
  33.      * 用戶輕觸觸摸屏,尚未鬆開或拖動,由一個1個MotionEvent ACTION_DOWN觸發  
  34.      * 注意和onDown()的區別,強調的是沒有鬆開或者拖動的狀態  
  35.      */  
  36.     public void onShowPress(MotionEvent e) {   
  37.         Log.i("MyGesture""onShowPress");   
  38.         Toast.makeText(this"onShowPress", Toast.LENGTH_SHORT).show();   
  39.     }   
  40.        
  41.     // 用戶(輕觸觸摸屏後)鬆開,由一個1個MotionEvent ACTION_UP觸發   
  42.     public boolean onSingleTapUp(MotionEvent e) {   
  43.         Log.i("MyGesture""onSingleTapUp");   
  44.         Toast.makeText(this"onSingleTapUp", Toast.LENGTH_SHORT).show();   
  45.         return true;   
  46.     }   
  47.        
  48.     // 用戶按下觸摸屏、快速移動後鬆開,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發   
  49.     public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {   
  50.         Log.i("MyGesture""onFling");   
  51.         Toast.makeText(this"onFling", Toast.LENGTH_LONG).show();   
  52.         return true;   
  53.     }   
  54.        
  55.     // 用戶按下觸摸屏,並拖動,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發   
  56.     public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {   
  57.         Log.i("MyGesture""onScroll");   
  58.         Toast.makeText(this"onScroll", Toast.LENGTH_LONG).show();   
  59.         return true;   
  60.     }   
  61.        
  62.     // 用戶長按觸摸屏,由多個MotionEvent ACTION_DOWN觸發   
  63.     public void onLongPress(MotionEvent e) {   
  64.         Log.i("MyGesture""onLongPress");   
  65.         Toast.makeText(this"onLongPress", Toast.LENGTH_LONG).show();   
  66.     }   
  67. }  
[java] view plaincopy
  1. public class MyGesture extends Activity implements OnTouchListener, OnGestureListener {  
  2.     private GestureDetector mGestureDetector;  
  3.     public MyGesture() {  
  4.         mGestureDetector = new GestureDetector(this);  
  5.     }  
  6.     public void onCreate(Bundle savedInstanceState) {  
  7.         super.onCreate(savedInstanceState);  
  8.         setContentView(R.layout.main);  
  9.         TextView tv = (TextView) findViewById(R.id.tv);  
  10.         tv.setOnTouchListener(this);  
  11.         tv.setFocusable(true);  
  12.         tv.setClickable(true);  
  13.         tv.setLongClickable(true);  
  14.         mGestureDetector.setIsLongpressEnabled(true);  
  15.     }  
  16.       
  17.     /* 
  18.      * 在onTouch()方法中,我們調用GestureDetector的onTouchEvent()方法,將捕捉到的MotionEvent交給GestureDetector 
  19.      * 來分析是否有合適的callback函數來處理用戶的手勢 
  20.      */   
  21.     public boolean onTouch(View v, MotionEvent event) {  
  22.         return mGestureDetector.onTouchEvent(event);  
  23.     }  
  24.   
  25.     // 用戶輕觸觸摸屏,由1個MotionEvent ACTION_DOWN觸發  
  26.     public boolean onDown(MotionEvent arg0) {  
  27.         Log.i("MyGesture""onDown");  
  28.         Toast.makeText(this"onDown", Toast.LENGTH_SHORT).show();  
  29.         return true;  
  30.     }  
  31.       
  32.     /* 
  33.      * 用戶輕觸觸摸屏,尚未鬆開或拖動,由一個1個MotionEvent ACTION_DOWN觸發 
  34.      * 注意和onDown()的區別,強調的是沒有鬆開或者拖動的狀態 
  35.      */  
  36.     public void onShowPress(MotionEvent e) {  
  37.         Log.i("MyGesture""onShowPress");  
  38.         Toast.makeText(this"onShowPress", Toast.LENGTH_SHORT).show();  
  39.     }  
  40.       
  41.     // 用戶(輕觸觸摸屏後)鬆開,由一個1個MotionEvent ACTION_UP觸發  
  42.     public boolean onSingleTapUp(MotionEvent e) {  
  43.         Log.i("MyGesture""onSingleTapUp");  
  44.         Toast.makeText(this"onSingleTapUp", Toast.LENGTH_SHORT).show();  
  45.         return true;  
  46.     }  
  47.       
  48.     // 用戶按下觸摸屏、快速移動後鬆開,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發  
  49.     public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {  
  50.         Log.i("MyGesture""onFling");  
  51.         Toast.makeText(this"onFling", Toast.LENGTH_LONG).show();  
  52.         return true;  
  53.     }  
  54.       
  55.     // 用戶按下觸摸屏,並拖動,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發  
  56.     public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {  
  57.         Log.i("MyGesture""onScroll");  
  58.         Toast.makeText(this"onScroll", Toast.LENGTH_LONG).show();  
  59.         return true;  
  60.     }  
  61.       
  62.     // 用戶長按觸摸屏,由多個MotionEvent ACTION_DOWN觸發  
  63.     public void onLongPress(MotionEvent e) {  
  64.         Log.i("MyGesture""onLongPress");  
  65.         Toast.makeText(this"onLongPress", Toast.LENGTH_LONG).show();  
  66.     }  
  67. }  
 

3. Fling事件的處理代碼:除了第一個觸發Fling的ACTION_DOWN和最後一個ACTION_MOVE中包含的座標等信息外,我們還可以根據用戶在X軸或者Y軸上的移動速度作爲條件。比如下面的代碼中我們就在用戶移動超過100個像素,且X軸上每秒的移動速度大於200像素時才進行處理。

Java代碼 複製代碼 收藏代碼
  1. public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {   
  2.     // 參數解釋:   
  3.     // e1:第1個ACTION_DOWN MotionEvent   
  4.     // e2:最後一個ACTION_MOVE MotionEvent   
  5.     // velocityX:X軸上的移動速度,像素/秒   
  6.     // velocityY:Y軸上的移動速度,像素/秒   
  7.   
  8.     // 觸發條件 :   
  9.     // X軸的座標位移大於FLING_MIN_DISTANCE,且移動速度大於FLING_MIN_VELOCITY個像素/秒   
  10.        
  11.     final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;   
  12.     if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) {   
  13.         // Fling left   
  14.         Log.i("MyGesture""Fling left");   
  15.         Toast.makeText(this"Fling Left", Toast.LENGTH_SHORT).show();   
  16.     } else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) {   
  17.         // Fling right   
  18.         Log.i("MyGesture""Fling right");   
  19.         Toast.makeText(this"Fling Right", Toast.LENGTH_SHORT).show();   
  20.     }   
  21.     return false;   
  22. }  
[java] view plaincopy
  1. public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {  
  2.     // 參數解釋:  
  3.     // e1:第1個ACTION_DOWN MotionEvent  
  4.     // e2:最後一個ACTION_MOVE MotionEvent  
  5.     // velocityX:X軸上的移動速度,像素/秒  
  6.     // velocityY:Y軸上的移動速度,像素/秒  
  7.   
  8.     // 觸發條件 :  
  9.     // X軸的座標位移大於FLING_MIN_DISTANCE,且移動速度大於FLING_MIN_VELOCITY個像素/秒  
  10.       
  11.     final int FLING_MIN_DISTANCE = 100, FLING_MIN_VELOCITY = 200;  
  12.     if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) {  
  13.         // Fling left  
  14.         Log.i("MyGesture""Fling left");  
  15.         Toast.makeText(this"Fling Left", Toast.LENGTH_SHORT).show();  
  16.     } else if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY) {  
  17.         // Fling right  
  18.         Log.i("MyGesture""Fling right");  
  19.         Toast.makeText(this"Fling Right", Toast.LENGTH_SHORT).show();  
  20.     }  
  21.     return false;  
  22. }  

 這個例子中,tv.setLongClickable( true )是必須的,因爲 只有這樣,view才能夠處理不同於Tap(輕觸)的hold(即ACTION_MOVE,或者多個ACTION_DOWN),我們同樣可以通過layout定義中的android:longClickable來做到這一點。

 

4. SimpleOnGestureListener

Java代碼 複製代碼 收藏代碼
  1. public class MyGesture extends Activity implements OnTouchListener {   
  2.     private GestureDetector mGestureDetector;   
  3.     public MyGesture() {   
  4.         mGestureDetector = new GestureDetector(new MySimpleGesture());   
  5.     }   
  6.     public void onCreate(Bundle savedInstanceState) {   
  7.         super.onCreate(savedInstanceState);   
  8.         setContentView(R.layout.main);   
  9.         TextView tv = (TextView) findViewById(R.id.tv);   
  10.         tv.setOnTouchListener(this);   
  11.         tv.setFocusable(true);   
  12.         tv.setClickable(true);   
  13.         tv.setLongClickable(true);   
  14.     }   
  15.     public boolean onTouch(View v, MotionEvent event) {   
  16.         if (event.getAction() == MotionEvent.ACTION_UP) {   
  17.             Log.i("MyGesture""MotionEvent.ACTION_UP");   
  18.         }   
  19.         return mGestureDetector.onTouchEvent(event);   
  20.     }   
  21.        
  22.     // SimpleOnGestureListener implements GestureDetector.OnDoubleTapListener, GestureDetector.OnGestureListener  
  23.     private class MySimpleGesture extends SimpleOnGestureListener {   
  24.         // 雙擊的第二下Touch down時觸發    
  25.         public boolean onDoubleTap(MotionEvent e) {   
  26.             Log.i("MyGesture""onDoubleTap");   
  27.             return super.onDoubleTap(e);   
  28.         }   
  29.            
  30.         // 雙擊的第二下Touch down和up都會觸發,可用e.getAction()區分   
  31.         public boolean onDoubleTapEvent(MotionEvent e) {   
  32.             Log.i("MyGesture""onDoubleTapEvent");   
  33.             return super.onDoubleTapEvent(e);   
  34.         }   
  35.            
  36.         // Touch down時觸發    
  37.         public boolean onDown(MotionEvent e) {   
  38.             Log.i("MyGesture""onDown");   
  39.             return super.onDown(e);   
  40.         }   
  41.            
  42.         // Touch了滑動一點距離後,up時觸發   
  43.         public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {   
  44.             Log.i("MyGesture""onFling");   
  45.             return super.onFling(e1, e2, velocityX, velocityY);   
  46.         }   
  47.            
  48.         // Touch了不移動一直Touch down時觸發   
  49.         public void onLongPress(MotionEvent e) {   
  50.             Log.i("MyGesture""onLongPress");   
  51.             super.onLongPress(e);   
  52.         }   
  53.            
  54.         // Touch了滑動時觸發   
  55.         public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {   
  56.             Log.i("MyGesture""onScroll");   
  57.             return super.onScroll(e1, e2, distanceX, distanceY);   
  58.         }   
  59.            
  60.         /*  
  61.          * Touch了還沒有滑動時觸發  
  62.          * (1)onDown只要Touch Down一定立刻觸發  
  63.          * (2)Touch Down後過一會沒有滑動先觸發onShowPress再觸發onLongPress  
  64.          * So: Touch Down後一直不滑動,onDown -> onShowPress -> onLongPress這個順序觸發。  
  65.          */  
  66.         public void onShowPress(MotionEvent e) {   
  67.             Log.i("MyGesture""onShowPress");   
  68.             super.onShowPress(e);   
  69.         }   
  70.   
  71.         /*  
  72.          * 兩個函數都是在Touch Down後又沒有滑動(onScroll),又沒有長按(onLongPress),然後Touch Up時觸發  
  73.          * 點擊一下非常快的(不滑動)Touch Up: onDown->onSingleTapUp->onSingleTapConfirmed  
  74.          * 點擊一下稍微慢點的(不滑動)Touch Up: onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed  
  75.          */    
  76.         public boolean onSingleTapConfirmed(MotionEvent e) {   
  77.             Log.i("MyGesture""onSingleTapConfirmed");   
  78.             return super.onSingleTapConfirmed(e);   
  79.         }   
  80.         public boolean onSingleTapUp(MotionEvent e) {   
  81.             Log.i("MyGesture""onSingleTapUp");   
  82.             return super.onSingleTapUp(e);   
  83.         }   
  84.     }   

發佈了22 篇原創文章 · 獲贊 3 · 訪問量 5萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章