在Android上,不止一個途徑來偵聽用戶和應(yīng)用程序之間交互的事件。對于用戶界面里的事件,偵聽方法就是從與用戶交互的特定視圖對象截獲這些事件。視圖類提供了相應(yīng)的手段。
在各種用來組建布局的視圖類里面,你可能會注意到一些公共的回調(diào)方法看起來對用戶界面事件有用。這些方法在該對象的相關(guān)動作發(fā)生時被Android框架調(diào)用。比如,當(dāng)一個視圖(如一個按鈕)被觸摸時,該對象上的onTouchEvent()方法會被調(diào)用。不過,為了偵聽這個事件,你必須擴(kuò)展這個類并重寫該方法。很明顯,擴(kuò)展每個你想使用的視圖對象(只是處理一個事件)是荒唐的。這就是為什么視圖類也包含了一個嵌套接口的集合,這些接口含有實(shí)現(xiàn)起來簡單得多的回調(diào)函數(shù)。這些接口叫做事件偵聽器event listeners,是用來截獲用戶和你的界面交互動作的"門票"。
當(dāng)你更為普遍的使用事件偵聽器來偵聽用戶動作時,總有那么一次你可能得為了創(chuàng)建一個自定義組件而擴(kuò)展一個視圖類。也許你想擴(kuò)展按鈕Button類來使某些事更花哨。在這種情況下,你將能夠使事件處理器event handlers類來為你的類定義缺省事件行為。
事件偵聽器Event Listeners
事件偵聽器是視圖View類的接口,包含一個單獨(dú)的回調(diào)方法。這些方法將在視圖中注冊的偵聽器被用戶界面操作觸發(fā)時由Android框架調(diào)用。下面這些回調(diào)方法被包含在事件偵聽器接口中:
onClick():包含于View.OnClickListener。當(dāng)用戶觸摸這個item(在觸摸模式下),或者通過瀏覽鍵或跟蹤球聚焦在這個item上,然后按下"確認(rèn)"鍵或者按下跟蹤球時被調(diào)用。
onLongClick():包含于View.OnLongClickListener。當(dāng)用戶觸摸并控制住這個item(在觸摸模式下),或者通過瀏覽鍵或跟蹤球聚焦在這個item上,然后保持按下"確認(rèn)"鍵或者按下跟蹤球(一秒鐘)時被調(diào)用。
onFocusChange():包含于View.OnFocusChangeListener。當(dāng)用戶使用瀏覽鍵或跟蹤球?yàn)g覽進(jìn)入或離開這個item時被調(diào)用。
onKey():包含于View.OnKeyListener。當(dāng)用戶聚焦在這個item上并按下或釋放設(shè)備上的一個按鍵時被調(diào)用。
onTouch():包含于View.OnTouchListener。當(dāng)用戶執(zhí)行的動作被當(dāng)做一個觸摸事件時被調(diào)用,包括按下,釋放,或者屏幕上任何的移動手勢(在這個item的邊界內(nèi))。
onCreateContextMenu():包含于View.OnCreateContextMenuListener。當(dāng)正在創(chuàng)建一個上下文菜單的時候被調(diào)用(作為持續(xù)的"長點(diǎn)擊"動作的結(jié)果)。
這些方法是它們相應(yīng)接口的唯一"住戶"。要定義這些方法并處理你的事件,在你的活動中實(shí)現(xiàn)這個嵌套接口或定義它為一個匿名類。然后,傳遞你的實(shí)現(xiàn)的一個實(shí)例給各自的View.set...Listener() 方法。(比如,調(diào)用setOnClickListener()并傳遞給它你的OnClickListener實(shí)現(xiàn)。)
下面的例子說明了如何為一個按鈕注冊一個點(diǎn)擊偵聽器:
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); ... } |
你可能會發(fā)現(xiàn)把OnClickListener作為活動的一部分來實(shí)現(xiàn)會便利的多。這將避免額外的類加載和對象分配。比如:
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()回調(diào)沒有返回值,但是一些其它事件偵聽器必須返回一個布爾值。原因和事件相關(guān)。對于其中一些,原因如下:
onLongClick() – 返回一個布爾值來指示你是否已經(jīng)消費(fèi)了這個事件而不應(yīng)該再進(jìn)一步處理它。也就是說,返回true 表示你已經(jīng)處理了這個事件而且到此為止;返回false 表示你還沒有處理它和/或這個事件應(yīng)該繼續(xù)交給其他on-click偵聽器。
onKey() –返回一個布爾值來指示你是否已經(jīng)消費(fèi)了這個事件而不應(yīng)該再進(jìn)一步處理它。也就是說,返回true 表示你已經(jīng)處理了這個事件而且到此為止;返回false 表示你還沒有處理它和/或這個事件應(yīng)該繼續(xù)交給其他on-key偵聽器。
onTouch() - 返回一個布爾值來指示你的偵聽器是否已經(jīng)消費(fèi)了這個事件。重要的是這個事件可以有多個彼此跟隨的動作。因此,如果當(dāng)接收到向下動作事件時你返回false,那表明你還沒有消費(fèi)這個事件而且對后續(xù)動作也不感興趣。那么,你將不會被該事件中的其他動作調(diào)用,比如手勢或最后出現(xiàn)向上動作事件。
記住按鍵事件總是遞交給當(dāng)前焦點(diǎn)所在的視圖。它們從視圖層次的頂層開始被分發(fā),然后依次向下,直到到達(dá)恰當(dāng)?shù)哪繕?biāo)。如果你的視圖(或者一個子視圖)當(dāng)前擁有焦點(diǎn),那么你可以看到事件經(jīng)由dispatchKeyEvent()方法分發(fā)。除了從你的視圖截獲按鍵事件,還有一個可選方案,你還可以在你的活動中使用onKeyDown() and onKeyUp()來接收所有的事件。
注意: Android 將首先調(diào)用事件處理器,其次是類定義中合適的缺省處理器。這樣,從這些事情偵聽器中返回true 將停止事件向其它事件偵聽器傳播并且也會阻塞視圖中的缺事件處理器的回調(diào)函數(shù)。因此當(dāng)你返回true時確認(rèn)你希望終止這個事件。
事件處理器Event Handlers
如果你從視圖創(chuàng)建一個自定義組件,那么你將能夠定義一些回調(diào)方法被用作缺省的事件處理器。在創(chuàng)建自定義組件Building Custom Components的文檔中,你將學(xué)習(xí)到一些用作事件處理的通用回調(diào)函數(shù),包括:
- onKeyDown(int, KeyEvent) - 當(dāng)一個新的按鍵事件發(fā)生時被調(diào)用。
- onKeyUp(int, KeyEvent) - 當(dāng)一個向上鍵事件發(fā)生時被調(diào)用。
- onTrackballEvent(MotionEvent) - 當(dāng)一個跟蹤球運(yùn)動事件發(fā)生時被調(diào)用。
- onTouchEvent(MotionEvent) - 當(dāng)一個觸摸屏移動事件發(fā)生時調(diào)用。
- onFocusChanged(boolean, int, Rect) - 當(dāng)視圖獲得或者丟失焦點(diǎn)時被調(diào)用。
你應(yīng)該知道還有一些其它方法,并不屬于視圖類的一部分,但可以直接影響你處理事件的方式。所以,當(dāng)在一個布局里管理更復(fù)雜的事件時,考慮一下這些方法:
- Activity.dispatchTouchEvent(MotionEvent) - 這允許你的活動可以在分發(fā)給窗口之前捕獲所有的觸摸事件。
- ViewGroup.onInterceptTouchEvent(MotionEvent) - 這允許一個視圖組ViewGroup 在分發(fā)給子視圖時觀察這些事件。
- ViewParent.requestDisallowInterceptTouchEvent(boolean) - 在一個父視圖之上調(diào)用這個方法來表示它不應(yīng)該通過onInterceptTouchEvent(MotionEvent)來捕獲觸摸事件。
觸摸模式Touch Mode
當(dāng)用戶使用方向鍵或跟蹤球?yàn)g覽用戶界面時,有必要給用戶可操作的item(比如按鈕)設(shè)置焦點(diǎn),這樣用戶可以知道哪個item將接受輸入。不過,如果這個設(shè)備有觸摸功能,而且用戶通過觸摸來和界面交互,那么就沒必要高亮items,或者設(shè)定焦點(diǎn)到一個特定的視圖。這樣,就有一個交互模式 叫"觸摸模式"。
對于一個具備觸摸功能的設(shè)備,一旦用戶觸摸屏幕,設(shè)備將進(jìn)入觸摸模式。自此以后,只有isFocusableInTouchMode()為真的視圖才可以被聚焦,比如文本編輯部件。其他可觸摸視圖,如按鈕,在被觸摸時將不會接受焦點(diǎn);它們將只是在被按下時簡單的觸發(fā)on-click偵聽器。任何時候用戶按下方向鍵或滾動跟蹤球,這個設(shè)備將退出觸摸模式,然后找一個視圖來接受焦點(diǎn),用戶也許不會通過觸摸屏幕的方式來恢復(fù)界面交互。
觸摸模式狀態(tài)的維護(hù)貫穿整個系統(tǒng)(所有窗口和活動)。為了查詢當(dāng)前狀態(tài),你可以調(diào)用isInTouchMode() 來查看這個設(shè)備當(dāng)前是否處于觸摸模式中。
處理焦點(diǎn)Handling Focus
框架將根據(jù)用戶輸入處理常規(guī)的焦點(diǎn)移動。這包含當(dāng)視圖刪除或隱藏,或者新視圖出現(xiàn)時改變焦點(diǎn)。視圖通過isFocusable()方法表明它們想獲取焦點(diǎn)的意愿。
要改變視圖是否可以接受焦點(diǎn),可以調(diào)用setFocusable()。在觸摸模式中,你可以通過isFocusableInTouchMode()查詢一個視圖是否允許接受焦點(diǎn)。你可以通過setFocusableInTouchMode()方法來改變它。焦點(diǎn)移動基于一個在給定方向查找最近鄰居的算法。少有的情況是,缺省算法可能和開發(fā)者的意愿行為不匹配。在這些情況下,你可以通過下面布局文件中的XML屬性提供顯式的重寫:nextFocusDown, nextFocusLeft, nextFocusRight, 和nextFocusUp。為失去焦點(diǎn)的視圖增加這些屬性之一。定義屬性值為擁有焦點(diǎn)的視圖的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> |
通常,在這個豎向布局中,從第一個按鈕向上瀏覽或者從第二個按鈕向下都不會移動到其它地方。現(xiàn)在這個頂部按鈕已經(jīng)定義了底部按鈕為nextFocusUp (反之亦然),瀏覽焦點(diǎn)將從上到下和從下到上循環(huán)移動。
如果你希望在用戶界面中聲明一個可聚焦的視圖(通常不是這樣),可以在你的布局定義中,為這個視圖增加android:focusable XML 屬性。把它的值設(shè)置成true。你還可以通過android:focusableInTouchMode在觸摸模式下聲明一個視圖為可聚焦。
想請求一個接受焦點(diǎn)的特定視圖,調(diào)用requestFocus()。
要偵聽焦點(diǎn)事件(當(dāng)一個視圖獲得或者失去焦點(diǎn)時被通知到),使用onFocusChange(),如上面事件偵聽器Event Listeners所描述的那樣。
觸摸事件、點(diǎn)擊事件的區(qū)別
針對屏幕上的一個View控件,Android如何區(qū)分應(yīng)當(dāng)觸發(fā)onTouchEvent,還是onClick,亦或是onLongClick事件?
在Android中,一次用戶操作可以被不同的View按次序分別處理,并將完全響應(yīng)了用戶一次UI操作稱之為消費(fèi)了該事件(consume),那么Android是按什么次序?qū)⑹录鬟f的呢?又在什么情況下判定為消費(fèi)了該事件?
搞清楚這些問題對于編寫出能正確響應(yīng)UI操作的代碼是很重要的,尤其當(dāng)屏幕上的不同View需要針對此次UI操作做出各種不同響應(yīng)的時候更是如此,一個典型例子就是用戶在桌面上放置了一個Widget,那么當(dāng)用戶針對widget做各種操作時,桌面本身有的時候要對用戶的操作做出響應(yīng),有時忽略。只有搞清楚事件觸發(fā)和傳遞的機(jī)制才有可能保證在界面布局非常復(fù)雜的情況下,UI控件仍然能正確響應(yīng)用戶操作。
1. onTouchEvent
onTouchEvent中要處理的最常用的3個事件就是:ACTION_DOWN、ACTION_MOVE、ACTION_UP。
這三個事件標(biāo)識出了最基本的用戶觸摸屏幕的操作,含義也很清楚。雖然大家天天都在用它們,但是有一點(diǎn)請留意,ACTION_DOWN事件作為起始事件,它的重要性是要超過ACTION_MOVE和ACTION_UP的,如果發(fā)生了ACTION_MOVE或者ACTION_UP,那么一定曾經(jīng)發(fā)生了ACTION_DOWN。
從Android的源代碼中能看到基于這種不同重要性的理解而實(shí)現(xiàn)的一些交互機(jī)制,SDK中也有明確的提及,例如在ViewGroup的onInterceptTouchEvent方法中,如果在ACTION_DOWN事件中返回了true,那么后續(xù)的事件將直接發(fā)給onTouchEvent,而不是繼續(xù)發(fā)給onInterceptTouchEvent。
2. onClick、onLongClick與onTouchEvent
曾經(jīng)看過一篇帖子提到,如果在View中處理了onTouchEvent,那么就不用再處理onClick了,因?yàn)锳ndroid只會觸發(fā)其中一個方法。這個理解是不太正確的,針對某個view,用戶完成了一次觸碰操作,顯然從傳感器上得到的信號是手指按下和抬起兩個操作,我們可以理解為一次Click,也可以理解為發(fā)生了一次ACTION_DOWN和ACTION_UP,那么Android是如何理解和處理的呢?
在Android中,onClick、onLongClick的觸發(fā)是和ACTION_DOWN及ACTION_UP相關(guān)的,在時序上,如果我們在一個View中同時覆寫了onClick、onLongClick及onTouchEvent的話,onTouchEvent是最先捕捉到ACTION_DOWN和ACTION_UP事件的,其次才可能觸發(fā)onClick或者onLongClick。主要的邏輯在View.java中的onTouchEvent方法中實(shí)現(xiàn)的:
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的觸發(fā)是在系統(tǒng)捕捉到ACTION_UP后發(fā)生并由performClick()執(zhí)行的,performClick里會調(diào)用先前注冊的監(jiān)聽器的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的觸發(fā)則是從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事件被捕捉后,系統(tǒng)會開始觸發(fā)一個postDelayed操作,delay的時間在Eclair2.1上為500ms,500ms后會觸發(fā)CheckForLongPress線程的執(zhí)行:
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中執(zhí)行performLongClick(),在這個方法中將調(diào)用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 ); } … } |
從實(shí)現(xiàn)中可以看到onClick()和onLongClick()方法是由ACTION_DOWN和ACTION_UP事件捕捉后根據(jù)各種情況最終確定是否觸發(fā)的,也就是說如果我們在一個Activity或者View中同時監(jiān)聽或者覆寫了onClick(),onLongClick()和onTouchEvent()方法,并不意味著只會發(fā)生其中一種。