Android事件分發機制

Android 中與 Touch 事件相關的方法包括：dispatchTouchEvent(MotionEvent ev)、onInterceptTouchEvent(MotionEvent ev)、onTouchEvent(MotionEvent ev)；能夠響應這些方法的控件包括：ViewGroup、View、Activity。方法與控件的對應關係如下表所示：

Touch事件相關方法	方法功能	ViewGroup	View	Activity
public boolean dispatchTouchEvent(MotionEvent ev)	事件分發	Yes	Yes	Yes
public boolean onInterceptTouchEvent(MotionEvent ev)	事件攔截	Yes	Yes	No
public boolean onTouchEvent(MotionEvent ev)	事件響應	Yes	Yes	Yes

-Activity 對 onInterceptTouchEvent(MotionEvent ev) 也就是事件攔截不進行響應

-另外需要注意的是 View 對 dispatchTouchEvent(MotionEvent ev) 和 onInterceptTouchEvent(MotionEvent ev) 的響應的前提是可以向該 View 中添加子 View，如果當前的 View 已經是一個最小的單元 View（比如 TextView），那麼就無法向這個最小 View 中添加子 View，也就無法向子 View 進行事件的分發和攔截，所以它沒有 dispatchTouchEvent(MotionEvent ev) 和 onInterceptTouchEvent(MotionEvent ev)，只有 onTouchEvent(MotionEvent ev)。

Touch 事件分析

dispatchTouchEvent(MotionEvent ev)

Touch 事件發生時 Activity 的dispatchTouchEvent(MotionEvent ev) 方法會以隧道方式（從根元素依次往下傳遞直到最內層子元素或在中間某一元素中由於某一條件停止傳遞）將事件傳遞給最外層 View 的 dispatchTouchEvent(MotionEvent ev) 方法，並由該 View 的 dispatchTouchEvent(MotionEvent ev) 方法對事件進行分發。dispatchTouchEvent 的事件分發邏輯如下：

*如果 return true 事件會分發給當前View並且由 dispatchTouchEvent 方法進行消費，同時 事件也會停止向 子View傳遞；

*如果 return false 事件分發機制分爲兩種情況：

1.如果當前 View 獲取的事件直接來自 Activity，則會將事件返回給 Activity 的 onTouchEvent 進行消費；

2.如果當前 View 獲取的事件來自外層父控件，則會將事件返回給父 View 的 onTouchEvent 進行消費。

*如果返回系統默認的 super.dispatchTouchEvent(ev) ，事件會自動的分發給當前 View 的 onInterceptTouchEvent 方法。

onInterceptTouchEvent(MotionEvent ev)

在外層 View 的 dispatchTouchEvent(MotionEvent ev) 方法返回系統默認的 super.dispatchTouchEvent(ev) 情況下，事件會自動的分發給當前 View 的 onInterceptTouchEvent 方法。onInterceptTouchEvent 的事件攔截邏輯如下：

*如果 onInterceptTouchEvent 返回 true，則表示將事件進行攔截，並將攔截到的事件交由當前 View 的 onTouchEvent 進行處理；

*如果 onInterceptTouchEvent 返回 false，則表示將事件放行，當前 View 上的事件會被傳遞到子 View 上，再由子 View 的 dispatchTouchEvent 來開始這個事件的分發；

*如果 onInterceptTouchEvent 返回 super.onInterceptTouchEvent(ev)，事件默認會被攔截，並將攔截到的事件交由當前 View 的 onTouchEvent 進行處理。

onTouchEvent(MotionEvent ev)

在當前 View 中 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev) 並且 onInterceptTouchEvent 返回 true 或返回 super.onInterceptTouchEvent(ev) 的情況下 onTouchEvent 會被調用。onTouchEvent 的事件響應邏輯如下：

*如果事件傳遞到當前 View 的 onTouchEvent 方法，而該方法返回了 false，那麼這個事件會從當前 View 向上傳遞，並且都是由上層 View 的 onTouchEvent 來接收，如果傳遞到上面的 onTouchEvent 也返回 false，這個事件就會“消失”，而且接收不到下一次事件。

*如果返回了 true 則會接收並消費該事件。

*如果返回 super.onTouchEvent(ev) 默認處理事件的邏輯和返回 false 時相同。

Touch 案例介紹

同樣在開始進行案例分析之前，我需要說明測試案例的結構，因爲所有的測試都是針對這一個案例來進行的，測試中只是通過修改每個控件中與 Touch 事件相關的三個方法的返回值來體現不同的情況。先來看張圖：

上面的圖爲測試案例的佈局文件 UI 顯示效果，佈局文件代碼如下：

<?xml version="1.0" encoding="utf-8"?>
<cn.sunzn.tevent.TouchEventFather xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:background="#468AD7"
    android:gravity="center"
    android:orientation="vertical" >

    <cn.sunzn.tevent.TouchEventChilds
        android:id="@+id/childs"
        android:layout_width="200dp"
        android:layout_height="200dp"
        android:layout_gravity="center"
        android:background="#E1110D"
        android:text="@string/hello" />

</cn.sunzn.tevent.TouchEventFather>

藍色背景爲一個自定義控件 TouchEventFather，該控件爲外層 View，繼承自 LinearLayout，實現代碼如下：

package cn.sunzn.tevent;

import android.content.Context;
import android.util.AttributeSet;
import android.util.Log;
import android.view.MotionEvent;
import android.widget.LinearLayout;

public class TouchEventFather extends LinearLayout {

    public TouchEventFather(Context context) {
        super(context);
    }

    public TouchEventFather(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    public boolean dispatchTouchEvent(MotionEvent ev) {
        Log.e("sunzn", "TouchEventFather | dispatchTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
        return super.dispatchTouchEvent(ev);
    }

    public boolean onInterceptTouchEvent(MotionEvent ev) {
        Log.i("sunzn", "TouchEventFather | onInterceptTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
        return super.onInterceptTouchEvent(ev);
    }

    public boolean onTouchEvent(MotionEvent ev) {
        Log.d("sunzn", "TouchEventFather | onTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
        return super.onTouchEvent(ev);
    }

}

紅色背景爲一個自定義控件 TouchEventChilds，該控件爲內層 View，爲 TouchEventFather 的子 View，同樣繼承自 LinearLayout，實現代碼如下：

package cn.sunzn.tevent;

import android.content.Context;
import android.util.AttributeSet;
import android.util.Log;
import android.view.MotionEvent;
import android.widget.LinearLayout;

public class TouchEventChilds extends LinearLayout {

    public TouchEventChilds(Context context) {
        super(context);
    }

    public TouchEventChilds(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    public boolean dispatchTouchEvent(MotionEvent ev) {
        Log.e("sunzn", "TouchEventChilds | dispatchTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
        return super.dispatchTouchEvent(ev);
    }

    public boolean onInterceptTouchEvent(MotionEvent ev) {
        Log.i("sunzn", "TouchEventChilds | onInterceptTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
        return super.onInterceptTouchEvent(ev);
    }

    public boolean onTouchEvent(MotionEvent ev) {
        Log.d("sunzn", "TouchEventChilds | onTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
        return super.onTouchEvent(ev);
    }

}

接着實現 Activity 的代碼，因爲控件所有的事件都是通過 Activity 的 dispatchTouchEvent 進行分發的；除此之外還需要重寫 Activity 的 onTouchEvent 方法，這是因爲如果一個控件直接從 Activity 獲取到事件，這個事件會首先被傳遞到控件的 dispatchTouchEvent 方法，如果這個方法 return false，事件會以冒泡方式返回給 Activity 的 onTouchEvent 進行消費。實現代碼如下：

package cn.sunzn.tevent;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import android.view.MotionEvent;

public class TouchEventActivity extends Activity {

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }

    public boolean dispatchTouchEvent(MotionEvent ev) {
        Log.w("sunzn", "TouchEventActivity | dispatchTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
        return super.dispatchTouchEvent(ev);
    }

    public boolean onTouchEvent(MotionEvent event) {
        Log.w("sunzn", "TouchEventActivity | onTouchEvent --> " + TouchEventUtil.getTouchAction(event.getAction()));
        return super.onTouchEvent(event);
    }

}

最後再附上 TouchEventUtil 的代碼，TouchEventUtil 中並沒有做多少事情，只是將以上 2 個自定義控件中各個方法的 MotionEvent 集中到一個工具類中並將其對應的動作以 String 形式返回，這樣處理更便於實時觀察控件的事件。代碼如下：

package cn.sunzn.tevent;

import android.view.MotionEvent;

public class TouchEventUtil {

    public static String getTouchAction(int actionId) {
        String actionName = "Unknow:id=" + actionId;
        switch (actionId) {
        case MotionEvent.ACTION_DOWN:
            actionName = "ACTION_DOWN";
            break;
        case MotionEvent.ACTION_MOVE:
            actionName = "ACTION_MOVE";
            break;
        case MotionEvent.ACTION_UP:
            actionName = "ACTION_UP";
            break;
        case MotionEvent.ACTION_CANCEL:
            actionName = "ACTION_CANCEL";
            break;
        case MotionEvent.ACTION_OUTSIDE:
            actionName = "ACTION_OUTSIDE";
            break;
        }
        return actionName;
    }

}

Touch 案例分析

Case 1

攔截條件如下

控件名稱	dispatchTouchEvent 返回值	onInterceptTouchEvent 返回值	onTouchEvent 返回值
TouchEventActivity	super.dispatchTouchEvent(ev)	無	super.onTouchEvent(ev)
TouchEventFather	false	super.onInterceptTouchEvent(ev)	super.onTouchEvent(ev)
TouchEventChilds	super.dispatchTouchEvent(ev)	super.onInterceptTouchEvent(ev)	super.onTouchEvent(ev)

運行結果

Level	Time	PID	Application	Tag	Hierarchy	Text
W	05-10 03:41:19.743	414	cn.sunzn.tevent	sunzn	TouchEventActivity	dispatchTouchEvent–> ACTION_DOWN
E	05-10 03:41:19.743	414	cn.sunzn.tevent	sunzn	TouchEventFather	dispatchTouchEvent–> ACTION_DOWN
W	05-10 03:41:19.743	414	cn.sunzn.tevent	sunzn	TouchEventActivity	onTouchEvent–> ACTION_DOWN
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_UP
					TouchEventActivity	onTouchEvent –> ACTION_UP

Case 2

控件名稱	dispatchTouchEvent 返回值	onInterceptTouchEvent 返回值	onTouchEvent 返回值
TouchEventActivity	super.dispatchTouchEvent(ev)	無	super.onTouchEvent(ev)
TouchEventFather	true	super.onInterceptTouchEvent(ev)	super.onTouchEvent(ev)
TouchEventChilds	super.dispatchTouchEvent(ev)	super.onInterceptTouchEvent(ev)	super.onTouchEvent(ev)

運行結果

Level	Time	PID	Application	Tag	Hierarchy	Text
		414	cn.sunzn.tevent	sunzn	TouchEventActivity	dispatchTouchEvent–> ACTION_DOWN
		414	cn.sunzn.tevent	sunzn	TouchEventFather	dispatchTouchEvent–> ACTION_DOWN
					TouchEventActivity	dispatchTouchEvent–> ACTION_MOVE
					TouchEventFather	dispatchTouchEvent–> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent–> ACTION_MOVE
					TouchEventFather	dispatchTouchEvent–> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent–> ACTION_MOVE
					TouchEventFathe	dispatchTouchEvent–> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent–> ACTION_UP
					TouchEventFathe	dispatchTouchEvent–> ACTION_UP

分析

代碼運行後，事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分發給 TouchEventFather 控件的 dispatchTouchEvent，而該控件的 dispatchTouchEvent 返回 true，表示分發事件到 TouchEventFather 控件並由該控件的 dispatchTouchEvent 進行消費；TouchEventActivity 不斷的分發事件到 TouchEventFather 控件的 dispatchTouchEvent，而 TouchEventFather 控件的 dispatchTouchEvent 也不斷的將獲取到的事件進行消費。

Case 3

控件名稱	dispatchTouchEvent 返回值	onInterceptTouchEvent 返回值	onTouchEvent 返回值
TouchEventActivity	super.dispatchTouchEvent(ev)	無	super.onTouchEvent(ev)
TouchEventFather	super.dispatchTouchEvent(ev)	true	super.onTouchEvent(ev)
TouchEventChilds	super.dispatchTouchEvent(ev)	super.onInterceptTouchEvent(ev)	super.onTouchEvent(ev)

運行結果

Level	Time	PID	Application	Tag	Hierarchy	Text
		481	cn.sunzn.tevent	sunzn	TouchEventActivity	dispatchTouchEvent–> ACTION_DOWN
		481	cn.sunzn.tevent	sunzn	TouchEventFather	dispatchTouchEvent–> ACTION_DOWN
					TouchEventFather	onInterceptTouchEvent –> ACTION_DOWN
					TouchEventFather	onTouchEvent –> ACTION_DOWN
					TouchEventActivity	onTouchEvent –> ACTION_DOWN
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_UP
					TouchEventActivity	onTouchEvent –> ACTION_UP

結果分析

代碼運行後，事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分發給 TouchEventFather 控件的 dispatchTouchEvent，而該控件的 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev)，表示對事件進行分發並向下傳遞給 TouchEventFather 控件的 onInterceptTouchEvent 方法，該方法返回 true 表示對所獲取到的事件進行攔截並將事件傳遞給 TouchEventFather 控件的 onTouchEvent 進行處理，TouchEventFather 控件的 onTouchEvent 返回 super.onTouchEvent(ev) 表示對事件沒有做任何處理直接將事件返回給上級控件，由於 TouchEventFather 獲取的事件直接來自 TouchEventActivity，所以 TouchEventFather 控件的 onTouchEvent 會將事件以冒泡方式直接返回給 TouchEventActivity 的 onTouchEvent 進行消費，後續的事件則會跳過 TouchEventFather 直接由 TouchEventActivity 的 onTouchEvent 消費來自 TouchEventActivity 自身分發的事件。

Case 4

控件名稱	dispatchTouchEvent 返回值	onInterceptTouchEvent 返回值	onTouchEvent 返回值
TouchEventActivity	super.dispatchTouchEvent(ev)	無	super.onTouchEvent(ev)
TouchEventFather	super.dispatchTouchEvent(ev)	false	super.onTouchEvent(ev)
TouchEventChilds	super.dispatchTouchEvent(ev)	super.onInterceptTouchEvent(ev)	super.onTouchEvent(ev)

運行結果

Level	Time	PID	Application	Tag	Hierarchy	Text
		481	cn.sunzn.tevent	sunzn	TouchEventActivity	dispatchTouchEvent–> ACTION_DOWN
		481	cn.sunzn.tevent	sunzn	TouchEventFather	dispatchTouchEvent–> ACTION_DOWN
					TouchEventFather	onInterceptTouchEvent –> ACTION_DOWN
					TouchEventChilds	dispatchTouchEvent –> ACTION_DOWN
					TouchEventChilds	onInterceptTouchEvent –> ACTION_DOWN
					TouchEventChilds	onTouchEvent –> ACTION_DOWN
					TouchEventFather	onTouchEvent –> ACTION_DOWN
					TouchEventActivity	onTouchEvent –> ACTION_DOWN
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	onTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_UP
					TouchEventActivity	onTouchEvent –> ACTION_UP

結果分析
代碼運行後，事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分發給 TouchEventFather 控件的 dispatchTouchEvent，而該控件的 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev)，表示對事件進行分發並向下傳遞給 TouchEventFather 控件的 onInterceptTouchEvent 方法，該方法返回 false 表示事件會被放行並傳遞到子控件 TouchEventChilds 的 dispatchTouchEvent 方法，同樣 TouchEventChilds 的 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev)，表示對事件進行分發並向下傳遞給 TouchEventChilds 控件的 onInterceptTouchEvent 方法，TouchEventChilds 的 onInterceptTouchEvent 方法返回 super.onInterceptTouchEvent(ev) 默認會將事件傳遞給 TouchEventChilds 的 onTouchEvent 進行處理，TouchEventChilds 的 onTouchEvent 返回 super.onTouchEvent(ev) 表示對事件沒有做任何處理直接將事件返回給上級控件，由於 TouchEventChilds 獲取的事件直接來自 TouchEventFather，所以 TouchEventChilds 控件的 onTouchEvent 會將事件以冒泡方式直接返回給 TouchEventFather 的 onTouchEvent 進行消費，而 TouchEventFather 的 onTouchEvent 也返回了 super.onTouchEvent(ev)，同樣 TouchEventFather 的 onTouchEvent 也會將事件返回給上級控件，而 TouchEventFather 獲取的事件直接來自 TouchEventActivity，所以 TouchEventFather 控件的 onTouchEvent 會將事件以冒泡方式直接返回給 TouchEventActivity 的 onTouchEvent 進行消費，後續的事件則會跳過 TouchEventFather 和 TouchEventChilds 直接由 TouchEventActivity 的 onTouchEvent 消費來自 TouchEventActivity 自身分發的事件。

Case 5

控件名稱	dispatchTouchEvent 返回值	onInterceptTouchEvent 返回值	onTouchEvent 返回值
TouchEventActivity	super.dispatchTouchEvent(ev)	無	super.onTouchEvent(ev)
TouchEventFather	super.dispatchTouchEvent(ev)	false	super.onTouchEvent(ev)
TouchEventChilds	true	super.onInterceptTouchEvent(ev)	super.onTouchEvent(ev)

運行結果

Level	Time	PID	Application	Tag	Hierarchy	Text
		574	cn.sunzn.tevent	sunzn	TouchEventActivity	dispatchTouchEvent –> ACTION_DOWN
		574	cn.sunzn.tevent	sunzn	TouchEventFather	dispatchTouchEvent–> ACTION_DOWN
					TouchEventFather	onInterceptTouchEvent –> ACTION_DOWN
					TouchEventChilds	dispatchTouchEvent –> ACTION_DOWN
					TouchEventActivity	dispatchTouchEvent –> ACTION_MOVE
					TouchEventFather	dispatchTouchEvent –> ACTION_MOVE
					TouchEventFather	onInterceptTouchEvent –> ACTION_MOVE
					TouchEventChilds	dispatchTouchEvent –> ACTION_MOVE
					TouchEventActivity	dispatchTouchEvent –> ACTION_UP
					TouchEventFather	dispatchTouchEvent –> ACTION_UP
					TouchEventFather	onInterceptTouchEvent –> ACTION_UP
					TouchEventChilds	dispatchTouchEvent –> ACTION_UP

結果分析
代碼運行後，事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分發給 TouchEventFather 控件的 dispatchTouchEvent，該控件的 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev)，事件會分發到 TouchEventFather 的 onInterceptTouchEvent，onInterceptTouchEvent 返回 false 表示放行當先事件；事件會被傳遞到子控件 TouchEventChilds 的 dispatchTouchEvent 方法，dispatchTouchEvent 返回 true 表示事件被分發到 TouchEventChilds 控件並由該控件的 dispatchTouchEvent 方法消費。後續的事件也會不斷的重複上面的邏輯最終被 TouchEventChilds 的 dispatchTouchEvent 消費。

原文地址：sunzn’Blog

源碼地址：TouchEvent.rar