在Android上,不止一個途徑來偵聽用戶和應用程序之間交互的事件。對于用戶界面里的事件,偵聽方法就是從與用戶交互的特定視圖對象截獲這些事件。視圖類提供了相應的手段。
在各種用來組建布局的視圖類里面,你可能會注意到一些公共的回調方法看起來對用戶界面事件有用。這些方法在該對象的相關動作發生時被Android框架調用。比如,當一個視圖(如一個按鈕)被觸摸時,該對象上的onTouchEvent()方法會被調用。不過,為了偵聽這個事件,你必須擴展這個類并重寫該方法。很明顯,擴展每個你想使用的視圖對象(只是處理一個事件)是荒唐的。這就是為什么視圖類也包含了一個嵌套接口的集合,這些接口含有實現起來簡單得多的回調函數。這些接口叫做事件偵聽器event listeners,是用來截獲用戶和你的界面交互動作的"門票"。
當你更為普遍的使用事件偵聽器來偵聽用戶動作時,總有那么一次你可能得為了創建一個自定義組件而擴展一個視圖類。也許你想擴展按鈕Button類來使某些事更花哨。在這種情況下,你將能夠使事件處理器event handlers類來為你的類定義缺省事件行為。
事件偵聽器Event Listeners
事件偵聽器是視圖View類的接口,包含一個單獨的回調方法。這些方法將在視圖中注冊的偵聽器被用戶界面操作觸發時由Android框架調用。下面這些回調方法被包含在事件偵聽器接口中:
onClick():包含于View.OnClickListener。當用戶觸摸這個item(在觸摸模式下),或者通過瀏覽鍵或跟蹤球聚焦在這個item上,然后按下"確認"鍵或者按下跟蹤球時被調用。
onLongClick():包含于View.OnLongClickListener。當用戶觸摸并控制住這個item(在觸摸模式下),或者通過瀏覽鍵或跟蹤球聚焦在這個item上,然后保持按下"確認"鍵或者按下跟蹤球(一秒鐘)時被調用。
onFocusChange():包含于View.OnFocusChangeListener。當用戶使用瀏覽鍵或跟蹤球瀏覽進入或離開這個item時被調用。
onKey():包含于View.OnKeyListener。當用戶聚焦在這個item上并按下或釋放設備上的一個按鍵時被調用。
onTouch():包含于View.OnTouchListener。當用戶執行的動作被當做一個觸摸事件時被調用,包括按下,釋放,或者屏幕上任何的移動手勢(在這個item的邊界內)。
onCreateContextMenu():包含于View.OnCreateContextMenuListener。當正在創建一個上下文菜單的時候被調用(作為持續的"長點擊"動作的結果)。
這些方法是它們相應接口的唯一"住戶"。要定義這些方法并處理你的事件,在你的活動中實現這個嵌套接口或定義它為一個匿名類。然后,傳遞你的實現的一個實例給各自的View.set...Listener() 方法。(比如,調用setOnClickListener()并傳遞給它你的OnClickListener實現。)
下面的例子說明了如何為一個按鈕注冊一個點擊偵聽器:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
// Create an anonymous implementation of OnClickListener private OnClickListener mCorkyListener = new OnClickListener() { public void onClick(View v) { // do something when the button is clicked } }; protected void onCreate(Bundle savedValues) { ... // Capture our button from layout Button button = (Button)findViewById(R.id.corky); // Register the onClick listener with the implementation above button.setOnClickListener(mCorkyListener); ... } |
你可能會發現把OnClickListener作為活動的一部分來實現會便利的多。這將避免額外的類加載和對象分配。比如:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
public class ExampleActivity extends Activity implements OnClickListener { protected void onCreate(Bundle savedValues) { ... Button button = (Button)findViewById(R.id.corky); button.setOnClickListener( this ); } // Implement the OnClickListener callback public void onClick(View v) { // do something when the button is clicked } ... } |
注意上面例子中的onClick()回調沒有返回值,但是一些其它事件偵聽器必須返回一個布爾值。原因和事件相關。對于其中一些,原因如下:
onLongClick() – 返回一個布爾值來指示你是否已經消費了這個事件而不應該再進一步處理它。也就是說,返回true 表示你已經處理了這個事件而且到此為止;返回false 表示你還沒有處理它和/或這個事件應該繼續交給其他on-click偵聽器。
onKey() –返回一個布爾值來指示你是否已經消費了這個事件而不應該再進一步處理它。也就是說,返回true 表示你已經處理了這個事件而且到此為止;返回false 表示你還沒有處理它和/或這個事件應該繼續交給其他on-key偵聽器。
onTouch() - 返回一個布爾值來指示你的偵聽器是否已經消費了這個事件。重要的是這個事件可以有多個彼此跟隨的動作。因此,如果當接收到向下動作事件時你返回false,那表明你還沒有消費這個事件而且對后續動作也不感興趣。那么,你將不會被該事件中的其他動作調用,比如手勢或最后出現向上動作事件。
記住按鍵事件總是遞交給當前焦點所在的視圖。它們從視圖層次的頂層開始被分發,然后依次向下,直到到達恰當的目標。如果你的視圖(或者一個子視圖)當前擁有焦點,那么你可以看到事件經由dispatchKeyEvent()方法分發。除了從你的視圖截獲按鍵事件,還有一個可選方案,你還可以在你的活動中使用onKeyDown() and onKeyUp()來接收所有的事件。
注意: Android 將首先調用事件處理器,其次是類定義中合適的缺省處理器。這樣,從這些事情偵聽器中返回true 將停止事件向其它事件偵聽器傳播并且也會阻塞視圖中的缺事件處理器的回調函數。因此當你返回true時確認你希望終止這個事件。
事件處理器Event Handlers
如果你從視圖創建一個自定義組件,那么你將能夠定義一些回調方法被用作缺省的事件處理器。在創建自定義組件Building Custom Components的文檔中,你將學習到一些用作事件處理的通用回調函數,包括:
- onKeyDown(int, KeyEvent) - 當一個新的按鍵事件發生時被調用。
- onKeyUp(int, KeyEvent) - 當一個向上鍵事件發生時被調用。
- onTrackballEvent(MotionEvent) - 當一個跟蹤球運動事件發生時被調用。
- onTouchEvent(MotionEvent) - 當一個觸摸屏移動事件發生時調用。
- onFocusChanged(boolean, int, Rect) - 當視圖獲得或者丟失焦點時被調用。
你應該知道還有一些其它方法,并不屬于視圖類的一部分,但可以直接影響你處理事件的方式。所以,當在一個布局里管理更復雜的事件時,考慮一下這些方法:
- Activity.dispatchTouchEvent(MotionEvent) - 這允許你的活動可以在分發給窗口之前捕獲所有的觸摸事件。
- ViewGroup.onInterceptTouchEvent(MotionEvent) - 這允許一個視圖組ViewGroup 在分發給子視圖時觀察這些事件。
- ViewParent.requestDisallowInterceptTouchEvent(boolean) - 在一個父視圖之上調用這個方法來表示它不應該通過onInterceptTouchEvent(MotionEvent)來捕獲觸摸事件。
觸摸模式Touch Mode
當用戶使用方向鍵或跟蹤球瀏覽用戶界面時,有必要給用戶可操作的item(比如按鈕)設置焦點,這樣用戶可以知道哪個item將接受輸入。不過,如果這個設備有觸摸功能,而且用戶通過觸摸來和界面交互,那么就沒必要高亮items,或者設定焦點到一個特定的視圖。這樣,就有一個交互模式 叫"觸摸模式"。
對于一個具備觸摸功能的設備,一旦用戶觸摸屏幕,設備將進入觸摸模式。自此以后,只有isFocusableInTouchMode()為真的視圖才可以被聚焦,比如文本編輯部件。其他可觸摸視圖,如按鈕,在被觸摸時將不會接受焦點;它們將只是在被按下時簡單的觸發on-click偵聽器。任何時候用戶按下方向鍵或滾動跟蹤球,這個設備將退出觸摸模式,然后找一個視圖來接受焦點,用戶也許不會通過觸摸屏幕的方式來恢復界面交互。
觸摸模式狀態的維護貫穿整個系統(所有窗口和活動)。為了查詢當前狀態,你可以調用isInTouchMode() 來查看這個設備當前是否處于觸摸模式中。
處理焦點Handling Focus
框架將根據用戶輸入處理常規的焦點移動。這包含當視圖刪除或隱藏,或者新視圖出現時改變焦點。視圖通過isFocusable()方法表明它們想獲取焦點的意愿。
要改變視圖是否可以接受焦點,可以調用setFocusable()。在觸摸模式中,你可以通過isFocusableInTouchMode()查詢一個視圖是否允許接受焦點。你可以通過setFocusableInTouchMode()方法來改變它。焦點移動基于一個在給定方向查找最近鄰居的算法。少有的情況是,缺省算法可能和開發者的意愿行為不匹配。在這些情況下,你可以通過下面布局文件中的XML屬性提供顯式的重寫:nextFocusDown, nextFocusLeft, nextFocusRight, 和nextFocusUp。為失去焦點的視圖增加這些屬性之一。定義屬性值為擁有焦點的視圖的ID。比如:
1
2
3
4
5
6
7
8
9
10
|
<LinearLayout android:orientation= "vertical" ... > <Button android:id= "@+id/top" android:nextFocusUp= "@+id/bottom" ... /> <Button android:id= "@+id/bottom" android:nextFocusDown= "@+id/top" ... /> </LinearLayout> |
通常,在這個豎向布局中,從第一個按鈕向上瀏覽或者從第二個按鈕向下都不會移動到其它地方。現在這個頂部按鈕已經定義了底部按鈕為nextFocusUp (反之亦然),瀏覽焦點將從上到下和從下到上循環移動。
如果你希望在用戶界面中聲明一個可聚焦的視圖(通常不是這樣),可以在你的布局定義中,為這個視圖增加android:focusable XML 屬性。把它的值設置成true。你還可以通過android:focusableInTouchMode在觸摸模式下聲明一個視圖為可聚焦。
想請求一個接受焦點的特定視圖,調用requestFocus()。
要偵聽焦點事件(當一個視圖獲得或者失去焦點時被通知到),使用onFocusChange(),如上面事件偵聽器Event Listeners所描述的那樣。
觸摸事件、點擊事件的區別
針對屏幕上的一個View控件,Android如何區分應當觸發onTouchEvent,還是onClick,亦或是onLongClick事件?
在Android中,一次用戶操作可以被不同的View按次序分別處理,并將完全響應了用戶一次UI操作稱之為消費了該事件(consume),那么Android是按什么次序將事件傳遞的呢?又在什么情況下判定為消費了該事件?
搞清楚這些問題對于編寫出能正確響應UI操作的代碼是很重要的,尤其當屏幕上的不同View需要針對此次UI操作做出各種不同響應的時候更是如此,一個典型例子就是用戶在桌面上放置了一個Widget,那么當用戶針對widget做各種操作時,桌面本身有的時候要對用戶的操作做出響應,有時忽略。只有搞清楚事件觸發和傳遞的機制才有可能保證在界面布局非常復雜的情況下,UI控件仍然能正確響應用戶操作。
1. onTouchEvent
onTouchEvent中要處理的最常用的3個事件就是:ACTION_DOWN、ACTION_MOVE、ACTION_UP。
這三個事件標識出了最基本的用戶觸摸屏幕的操作,含義也很清楚。雖然大家天天都在用它們,但是有一點請留意,ACTION_DOWN事件作為起始事件,它的重要性是要超過ACTION_MOVE和ACTION_UP的,如果發生了ACTION_MOVE或者ACTION_UP,那么一定曾經發生了ACTION_DOWN。
從Android的源代碼中能看到基于這種不同重要性的理解而實現的一些交互機制,SDK中也有明確的提及,例如在ViewGroup的onInterceptTouchEvent方法中,如果在ACTION_DOWN事件中返回了true,那么后續的事件將直接發給onTouchEvent,而不是繼續發給onInterceptTouchEvent。
2. onClick、onLongClick與onTouchEvent
曾經看過一篇帖子提到,如果在View中處理了onTouchEvent,那么就不用再處理onClick了,因為Android只會觸發其中一個方法。這個理解是不太正確的,針對某個view,用戶完成了一次觸碰操作,顯然從傳感器上得到的信號是手指按下和抬起兩個操作,我們可以理解為一次Click,也可以理解為發生了一次ACTION_DOWN和ACTION_UP,那么Android是如何理解和處理的呢?
在Android中,onClick、onLongClick的觸發是和ACTION_DOWN及ACTION_UP相關的,在時序上,如果我們在一個View中同時覆寫了onClick、onLongClick及onTouchEvent的話,onTouchEvent是最先捕捉到ACTION_DOWN和ACTION_UP事件的,其次才可能觸發onClick或者onLongClick。主要的邏輯在View.java中的onTouchEvent方法中實現的:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
case MotionEvent.ACTION_DOWN: mPrivateFlags |= PRESSED; refreshDrawableState(); if ((mViewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) { postCheckForLongClick(); } break ; case MotionEvent.ACTION_UP: if ((mPrivateFlags & PRESSED) != 0 ) { boolean focusTaken = false ; if (isFocusable() && isFocusableInTouchMode() && !isFocused()) { focusTaken = requestFocus(); } if (!mHasPerformedLongPress) { if (mPendingCheckForLongPress != null ) { removeCallbacks(mPendingCheckForLongPress); } if (!focusTaken) { performClick(); } } … break ; |
可以看到,Click的觸發是在系統捕捉到ACTION_UP后發生并由performClick()執行的,performClick里會調用先前注冊的監聽器的onClick()方法:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
public boolean performClick() { … if (mOnClickListener != null ) { playSoundEffect(SoundEffectConstants.CLICK); mOnClickListener.onClick( this ); return true ; } return false ; } |
LongClick的觸發則是從ACTION_DOWN開始,由postCheckForLongClick()方法完成:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
private void postCheckForLongClick() { mHasPerformedLongPress = false ; if (mPendingCheckForLongPress == null ) { mPendingCheckForLongPress = new CheckForLongPress(); } mPendingCheckForLongPress.rememberWindowAttachCount(); postDelayed(mPendingCheckForLongPress, ViewConfiguration.getLongPressTimeout()); } |
可以看到,在ACTION_DOWN事件被捕捉后,系統會開始觸發一個postDelayed操作,delay的時間在Eclair2.1上為500ms,500ms后會觸發CheckForLongPress線程的執行:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
class CheckForLongPress implements Runnable { … public void run() { if (isPressed() && (mParent != null ) && mOriginalWindowAttachCount == mWindowAttachCount) { if (performLongClick()) { mHasPerformedLongPress = true ; } } } … } |
如果各種條件都滿足,那么在CheckForLongPress中執行performLongClick(),在這個方法中將調用onLongClick():
1
2
3
4
5
6
7
8
9
10
11
12
13
|
public boolean performLongClick() { … if (mOnLongClickListener != null ) { handled = mOnLongClickListener.onLongClick(View. this ); } … } |
從實現中可以看到onClick()和onLongClick()方法是由ACTION_DOWN和ACTION_UP事件捕捉后根據各種情況最終確定是否觸發的,也就是說如果我們在一個Activity或者View中同時監聽或者覆寫了onClick(),onLongClick()和onTouchEvent()方法,并不意味著只會發生其中一種。