我們先來明確一些概念,首先,Android的事件處理機制是基於Listener(監聽器)來實現的,比我們今天所說的觸摸屏相關的事件,就是通 過onTouchListener。其次,所有View的子類都可以通過setOnTouchListener()、 setOnKeyListener()等方法來添加對某一類事件的監聽器(注冊監聽)。第三,Listener一般會以Interface(接口)的方式來提供,其中 包含一個或多個abstract(抽象)方法,我們需要實現這些方法來完成onTouch()、onKey()等等的操作。這樣,當我們給某個view設 置了事件Listener,並實現了其中的抽象方法以后,程序便可以在特定的事件被dispatch到該view的時候,通過callbakc函數給予適 當的響應。
看一個簡單的例子,就用最簡單的TextView來說明(事實上和ADT中生成的skeleton沒有什么區別)。
public class GestureTest extends Activity implements OnTouchListener{ @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); mGesturedetector = new GestureDetector(this);//這里要先設置監聽的哦,不然的話 會報空指針異常. // init TextView TextView tv = (TextView) findViewById(R.id.page); // set OnTouchListener on TextView tv.setOnTouchListener(this); // show some text tv.setText(R.string.text); }
我們給TextView的實例tv設定了一個onTouchListener,因為GestureTest類實現了OnTouchListener 接口,所以簡單的給一個this作為參數即可。onTouch方法則是實現了OnTouchListener中的抽象方法,我們只要在這里添加邏輯代碼即 可在用戶觸摸屏幕時做出響應,就像我們這里所做的——打出一個提示信息。
這里,我們可以通過MotionEvent的getAction()方法來獲取Touch事件的類型,包括 ACTION_DOWN, ACTION_MOVE, ACTION_UP, 和ACTION_CANCEL。ACTION_DOWN是指按下觸摸屏,ACTION_MOVE是指按下觸摸屏后移動受力點,ACTION_UP則是指松 開觸摸屏,ACTION_CANCEL不會由用戶直接觸發(所以不在今天的討論范圍,請參考ViewGroup.onInterceptTouchEvent(MotionEvent))。借助對於用戶不同操作的判斷,結合getRawX()、getRawY()、getX()和getY()等方法來獲取坐標后,我們可以實現諸如拖動某一個按鈕,拖動滾動條等功能。待機可以看看MotionEvent類的文檔,另外也可以看考TouchPaint例子。
回到今天所要說的重點,當我們捕捉到Touch操作的時候,如何識別出用戶的Gesture?這里我們需要GestureDetector.OnGestureListener接口的幫助,於是我們的GestureTest類就變成了這個樣子。
01.public class GestureTest extends Activity implements OnTouchListener, OnGestureListener {
02.}
隨后,在onTouch()方法中,我們調用GestureDetector的onTouchEvent()方法,將捕捉到的MotionEvent交給 GestureDetector 來分析是否有合適的callback函數來處理用戶的手勢。
@Override
public boolean onTouch(View v, MotionEvent event) {
// OnGestureListener will analyzes the given motion event
//這里的mGestureDetector是該Activity的一個屬性.在構造方法中實例化或在oncreate()方法中實例化.
return mGestureDetector.onTouchEvent(event);
}
接下來,我們實現了以下6個抽象方法,其中最有用的當然是onFling()、onScroll()和onLongPress()了。我已經把每一個方法代表的手勢的意思寫在了注釋里,大家看一下就明白了。
// 用戶輕觸觸摸屏,由1個MotionEvent ACTION_DOWN觸發Java代碼
01.@Override
02.public boolean onDown(MotionEvent e) {
05. Toast.makeText(this, "onDown", Toast.LENGTH_SHORT).show();
07. return false;
08.}
10.// 用戶輕觸觸摸屏,尚未松開或拖動,由一個1個MotionEvent ACTION_DOWN觸發
11.// 注意和onDown()的區別,強調的是沒有松開或者拖動的狀態
13.@Override
14.public void onShowPress(MotionEvent e) {
17.}
@Override
public boolean onDown(MotionEvent e) {
// TODO Auto-generated method stub
Toast.makeText(this, "onDown", Toast.LENGTH_SHORT).show();
return false;
}
//用戶(輕觸觸摸屏后)松開,由一個1個MotionEvent ACTION_UP觸發
01.@Override
03.public boolean onSingleTapUp(MotionEvent e) {
05. return false;
06.}
//用戶按下觸摸屏、快速移動后松開,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發
01.@Override
02.public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,
03.
04.float velocityY) {
05. // TODO Auto-generated method stub
06. return false;
07.}
08.
09.// 用戶長按觸摸屏,由多個MotionEvent ACTION_DOWN觸發
10.@Override
11.public void onLongPress(MotionEvent e) {
12. // TODO Auto-generated method stub
13.}
14.
15.// 用戶按下觸摸屏,並拖動,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE觸發
16.@Override
17.public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
18.// TODO Auto-generated method stub
19. return false;
20.}
我們來試着做一個onFling()事件的處理吧,onFling()方法中每一個參數的意義我寫在注釋中了,需要注意的是Fling事件的處理代 碼中,除了第一個觸發Fling的ACTION_DOWN和最后一個ACTION_MOVE中包含的坐標等信息外,我們還可以根據用戶在X軸或者Y軸上的 移動速度作為條件。比如下面的代碼中我們就在用戶移動超過100個像素,且X軸上每秒的移動速度大於200像素時才進行處理。
01.@Override
02.public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
03.
04.// 參數解釋:
05.// e1:第1個ACTION_DOWN MotionEvent
06.// e2:最后一個ACTION_MOVE MotionEvent
07.// velocityX:X軸上的移動速度,像素/秒
08.// velocityY:Y軸上的移動速度,像素/秒
09.// 觸發條件 :
10.// X軸的坐標位移大於FLING_MIN_DISTANCE,且移動速度大於FLING_MIN_VELOCITY個像素/秒
11.if (e1.getX() - e2.getX() > FLING_MIN_DISTANCE
12. && Math.abs(velocityX) > FLING_MIN_VELOCITY) {
14. // Fling left
15. Toast.makeText(this, "Fling Left", Toast.LENGTH_SHORT).show();
16. } else
17.if (e2.getX() - e1.getX() > FLING_MIN_DISTANCE
18. && Math.abs(velocityX) > FLING_MIN_VELOCITY) {
19.
20. // Fling right
21. Toast.makeText(this, "Fling Right", Toast.LENGTH_SHORT).show();
22.}
24. return false;
25.}
問題是,這個時候如果我們嘗試去運行程序,你會發現我們根本得不到想要的結果,跟蹤代碼的執行的會發現onFling()事件一直就沒有被捕捉到。這正是一開始困擾我的問題,這到底是為什么呢?
我在討論組的Gesture detection這個帖子里找到了答案,即我們需要在onCreate中tv.setOnTouchListener(this);之后添加如下一句代碼。
tv.setLongClickable(true);
只有這樣,view才能夠處理不同於Tap(輕觸)的hold(即ACTION_MOVE,或者多個ACTION_DOWN),我們同樣可以通過layout定義中的android:longClickable來做到這一點。
這次遇到的這個問題和上次MapView中setOnKeyListener遇到的問題挺類似,其實都是對SDK的了解不夠全面,遇到了一次記住了就好。不過話說回來,Google在文檔方面確實需要加強了,起碼可以在OnGestureListener中說明需要滿足那些條件才可以保證手勢被正確識別.
OnGestureListener小結
一個activity中new一個GestureDetector之后,里面會實現一下的方法:
onSingleTapUp
onShowPress
onScroll
onLongPress
onFling
onDown
說一下這些方法都是由那些MotionEvent觸發的
今天的項目用到了onSingleTapUp和onShowPress和onLongPress和onFling;
1、onSingleTapUp、onSingleTapConfirmed
用戶(輕觸觸摸屏后)松開,由一個1個MotionEvent ACTION_UP觸發
這個事件執行的順序是onDown-》onShowPress-》onSingleTapUp
區別:
點擊一下非常快的(不滑動)Touchup:onDown->onSingleTapUp->onSingleTapConfirmed
點擊一下稍微慢點的(不滑 動)Touchup:onDown->onShowPress->onSingleTapUp->onSingleTapConfirmed
2、onShowPress
用戶輕觸觸摸屏,尚未松開或拖動,由一個1個MotionEvent ACTION_DOWN觸發
它與onDown()的區別,強調的是沒有松開或者拖動的狀態
3、onDown
而onDown也是由一個MotionEvent ACTION_DOWN觸發的,但是他沒有任何限制,也就是說當用戶點擊的時候,首先MotionEvent ACTION_DOWN,onDown就會執行,如果在按下的瞬間沒有松開或者是拖動的時候onShowPress就會執行,如果是按下的時間超過瞬間(這塊我也不太清楚瞬間的時間差是多少,一般情況下都會執行onShowPress),拖動了,就不執行onShowPress。
4、onLongPress
用戶長按觸摸屏,由多個MotionEvent ACTION_DOWN觸發
這個事件執行的順序是onDown-》onShowPress-》onLongPress
5、onFling
用戶按下觸摸屏、快速移動后松開,由1個MotionEvent ACTION_DOWN, 多個ACTION_MOVE, 1個ACTION_UP觸發
6、onScroll
Touch了 滑動時觸發。
另外需要說的一點就是:
如果你是在一個大的view上裝載了一個一個的小view,如果你想讓大的view有界面動態效果(比如左右向下滑動),那么你必須將這些小的view加入setOnTouchListener,然后你可以在OnTouchListener方法中加入如下方法將你的MotionEvent事件傳到gestureDetector中。如下:
switch (event.getAction()) {
case MotionEvent.ACTION_MOVE: {
gestureDetector.onTouchEvent(event);
break;
}// inner case MOVE
case MotionEvent.ACTION_UP: {
v.setPressed(false);
Log.i("cat", "CCCCCCCCCCCCCCCC");
gestureDetector.onTouchEvent(event);
// TODO animation
return true;
}// inner case UP
case MotionEvent.ACTION_DOWN: {
v.setPressed(true);
gestureDetector.onTouchEvent(event);
break;
}// inner case UP
}// inner switch
6、滑動屏幕效果GestureDetector、OnGestureListener、ViewFlipper
通過GestureDetector、OnGestureListener實現滑屏事件。ViewFlipper是繼承至FrameLayout的,所以它是一個Layout里面可以放置多個View。示例中第一頁僅放了一個按鈕BUTTON,向下滑屏時,每頁都只放了一個TEXTVIEW.