Android 的觸控事件分發機制是面試與實務的雙重重點。它牽涉三個方法、三類角色,還有兩種傳遞模式。與其背結論,不如把每種情境都跑出來看一次。
相關方法有三個:
dispatchTouchEvent(MotionEvent ev):事件分發,負責決定「這件事要給誰處理」。onInterceptTouchEvent(MotionEvent ev):事件攔截,只有 ViewGroup 有。onTouchEvent(MotionEvent ev):事件消費,真正處理事件的地方。能回應這些方法的角色有三類:Activity、ViewGroup、View。繼承 ViewGroup 的多是容器(LinearLayout、FrameLayout 等),繼承 View 的多是顯示控件(TextView、ImageView 等)。注意 ViewGroup 本身也繼承自 View,但顯示控件沒有 onInterceptTouchEvent——它們沒有子元素可攔。
public class MainActivity extends Activity {
private static final String TAG = "MainActivity";
@Override protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
@Override public boolean dispatchTouchEvent(MotionEvent ev) {
switch (ev.getAction()) {
case MotionEvent.ACTION_DOWN: Log.i(TAG, "dispatchTouchEvent--ACTION_DOWN"); break;
case MotionEvent.ACTION_MOVE: Log.i(TAG, "dispatchTouchEvent--ACTION_MOVE"); break;
case MotionEvent.ACTION_UP: Log.i(TAG, "dispatchTouchEvent--ACTION_UP"); break;
}
return super.dispatchTouchEvent(ev);
}
@Override public boolean onTouchEvent(MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN: Log.i(TAG, "onTouchEvent--ACTION_DOWN"); break;
case MotionEvent.ACTION_MOVE: Log.i(TAG, "onTouchEvent--ACTION_MOVE"); break;
case MotionEvent.ACTION_UP: Log.i(TAG, "onTouchEvent--ACTION_UP"); break;
}
return super.onTouchEvent(event);
}
}

可以看到:永遠先執行 dispatchTouchEvent,再執行 onTouchEvent。


只執行了 dispatchTouchEvent,onTouchEvent 完全沒被呼叫。這說明在 Activity 中 dispatchTouchEvent 先於 onTouchEvent 執行;若 dispatchTouchEvent 回傳 true,代表事件已被消費,不再往下傳遞。

public class MyButton extends Button {
private static final String TAG = "MyButton";
public MyButton(Context context) { super(context); }
public MyButton(Context context, AttributeSet attrs) { super(context, attrs); }
@Override public boolean dispatchTouchEvent(MotionEvent ev) {
switch (ev.getAction()) {
case MotionEvent.ACTION_DOWN: Log.i(TAG, "dispatchTouchEvent--ACTION_DOWN"); break;
case MotionEvent.ACTION_MOVE: Log.i(TAG, "dispatchTouchEvent--ACTION_MOVE"); break;
case MotionEvent.ACTION_UP: Log.i(TAG, "dispatchTouchEvent--ACTION_UP"); break;
}
return super.dispatchTouchEvent(ev);
}
@Override public boolean onTouchEvent(MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN: Log.i(TAG, "onTouchEvent--ACTION_DOWN"); break;
case MotionEvent.ACTION_MOVE: Log.i(TAG, "onTouchEvent--ACTION_MOVE"); break;
case MotionEvent.ACTION_UP: Log.i(TAG, "onTouchEvent--ACTION_UP"); break;
}
return super.onTouchEvent(event);
}
}
MainActivity 中取得該按鈕並沿用情境 1 的兩個方法:
but = (MyButton) findViewById(R.id.but);
點擊按鈕後的日誌:

執行流程是:Activity 先捕獲 ACTION_DOWN → 呼叫 Activity 的 dispatchTouchEvent → 繞開 Activity 的 onTouchEvent,直接把事件交給子控件 → 呼叫 MyButton 的 dispatchTouchEvent → 再呼叫它的 onTouchEvent。ACTION_UP 走同樣的路徑。

這裡有個關鍵結論:事件一旦成功交給子元素處理,父元素的 onTouchEvent 就被跳過了。
與情境 2 同理,但這次有子控件。事件不會被分發給 Button:

事件傳到 button 時先被 dispatchTouchEvent 捕獲,因回傳 true 而就地消費,不再往下傳,所以 Button 的 onTouchEvent 不會被呼叫。


事件傳到 button 後,因 onTouchEvent 回傳 false,於是交回上層由 Activity 的 onTouchEvent 接手。而且接下來的 ACTION_UP 不再傳給 button,直接由 Activity 捕獲——一旦某個元素表態不消費,後續事件就不再送給它。
public class MainActivity extends Activity implements OnClickListener, OnTouchListener {
@Override protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
but = (MyButton) findViewById(R.id.but);
but.setOnClickListener(this);
but.setOnTouchListener(this);
}
@Override public void onClick(View v) { Log.i("MyButton", "ONCLICK"); }
@Override public boolean onTouch(View v, MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN: Log.i("MyButton", "onTouch--ACTION_DOWN"); break;
case MotionEvent.ACTION_MOVE: Log.i("MyButton", "onTouch--ACTION_MOVE"); break;
case MotionEvent.ACTION_UP: Log.i("MyButton", "onTouch--ACTION_UP"); break;
}
return false;
}
// dispatchTouchEvent / onTouchEvent 同情境 1
}
點擊後的日誌:

流程為:Activity 的 dispatchTouchEvent → Button 的 dispatchTouchEvent → 並未呼叫 button 的 onTouchEvent,而是先呼叫 onTouch(因為註冊了 OnTouchListener)→ onTouch 回傳 false,事件才繼續傳給 button 的 onTouchEvent。ACTION_UP 過程類似,但 button 的 onTouchEvent 結束後,還多呼叫了 onClick。

所以 onTouch 的優先級高於 onTouchEvent,而 onClick 是在 onTouchEvent 內部被觸發的。
改成 true 之後,事件不再被 button 的 onTouchEvent 捕獲,而是直接被消費:

但值得注意的是,onClick 也沒有被執行。這印證了上一段的猜測:onClick 是在 onTouchEvent 裡被呼叫的。原始碼可以佐證:
case MotionEvent.ACTION_UP:
boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
// 取得焦點(若尚未取得且應該取得)
boolean focusTaken = false;
if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
focusTaken = requestFocus();
}
if (!mHasPerformedLongPress) {
removeLongPressCallback();
if (!focusTaken) {
// 用 post 而非直接呼叫,讓視圖的視覺狀態先更新
if (mPerformClick == null) {
mPerformClick = new PerformClick();
}
if (!post(mPerformClick)) {
performClick();
}
}
}
// 復原 pressed 狀態...
}
break;
而 performClick 才是真正觸發監聽器的地方:
public boolean performClick() {
sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
ListenerInfo li = mListenerInfo;
if (li != null && li.mOnClickListener != null) {
playSoundEffect(SoundEffectConstants.CLICK);
li.mOnClickListener.onClick(this);
return true;
}
return false;
}
前面都是顯示控件。現在換成繼承 ViewGroup 的容器,它多了一個 onInterceptTouchEvent(預設回傳 false,表示不攔截)。
public class MyLinearLayout extends LinearLayout {
private static final String TAG = "MyLinearLayout";
public MyLinearLayout(Context context) { super(context); }
public MyLinearLayout(Context context, AttributeSet attrs) { super(context, attrs); }
@Override public boolean onInterceptTouchEvent(MotionEvent ev) {
switch (ev.getAction()) {
case MotionEvent.ACTION_DOWN: Log.i(TAG, "onInterceptTouchEvent--ACTION_DOWN"); break;
case MotionEvent.ACTION_MOVE: Log.i(TAG, "onInterceptTouchEvent--ACTION_MOVE"); break;
case MotionEvent.ACTION_UP: Log.i(TAG, "onInterceptTouchEvent--ACTION_UP"); break;
}
return super.onInterceptTouchEvent(ev);
}
// dispatchTouchEvent 與 onTouchEvent 同前面的寫法
}
點擊按鈕後:

多了一層容器之後,Activity 執行完 dispatchTouchEvent 便將事件交給 MyLinearLayout,接著不是直接傳給 button,而是先執行 onInterceptTouchEvent。它回傳 false 不攔截,事件才繼續往下給 button。

把 onInterceptTouchEvent 的返回值改成 true:

事件被攔截後不再傳給 button,而是由 MyLinearLayout 的 onTouchEvent 接收,接著交給 MainActivity 的 onTouchEvent 消費。ACTION_UP 同樣直接由 Activity 處理。
1. 事件傳遞有兩種基本方式:
2. Android 的實作是兩者的混合:先由外層往下分發(dispatchTouchEvent,類似隧道),再由內層優先處理並把結果以 boolean 往上回報(先 onTouchListener,再 onTouchEvent,類似冒泡)。若某層回傳 true,上層就不再處理。
3. 三個方法的精確規則:
事件分發 public boolean dispatchTouchEvent(MotionEvent ev)
Touch 事件發生時,Activity 的 dispatchTouchEvent 以隧道方式把事件往下傳。其分發邏輯為:
事件攔截 public boolean onInterceptTouchEvent(MotionEvent ev)
事件消費 public boolean onTouchEvent(MotionEvent ev)
在 dispatchTouchEvent 回傳 super 且 onInterceptTouchEvent 回傳 true 或 super 的情況下,onTouchEvent 會被呼叫。
實務上最該記住的一句話:自訂控件若要完整處理一組 DOWN-MOVE-UP,onTouchEvent 對 ACTION_DOWN 必須回傳 true,否則後續的 MOVE 與 UP 都不會再送進來。