天天看点

Android中Touch 事件的分发和消费机制

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

从这张表中我们可以看到 ViewGroup 和 View 对与 Touch 事件相关的三个方法均能响应,而 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 事件分析

▐ 事件分发:public boolean dispatchTouchEvent(MotionEvent ev)

Touch 事件发生时 Activity 的 dispatchTouchEvent(MotionEvent ev) 方法会以隧道方式(从根元素依次往下传递直到最内层子元素或在中间某一元素中由于某一条件停止传递)将事件传递给最外层 View 的 dispatchTouchEvent(MotionEvent ev) 方法,并由该 View 的 dispatchTouchEvent(MotionEvent ev) 方法对事件进行分发。dispatchTouchEvent 的事件分发逻辑如下:

  • 如果 return true,事件会分发给当前 View 并由 dispatchTouchEvent 方法进行消费,同时事件会停止向下传递;
  • 如果 return false,事件分发分为两种情况:
  1. 如果当前 View 获取的事件直接来自 Activity,则会将事件返回给 Activity 的 onTouchEvent 进行消费;
  2. 如果当前 View 获取的事件来自外层父控件,则会将事件返回给父 View 的  onTouchEvent 进行消费。
  • 如果返回系统默认的 super.dispatchTouchEvent(ev),事件会自动的分发给当前 View 的 onInterceptTouchEvent 方法。

▐ 事件拦截:public boolean 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)和返回false的处理逻辑一样。

▐ 事件响应:public boolean onTouchEvent(MotionEvent ev)

在 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 案例介绍

同样在开始进行案例分析之前,我需要说明测试案例的结构,因为所有的测试都是针对这一个案例来进行的,测试中只是通过修改每个控件中与 Touch 事件相关的三个方法的返回值来体现不同的情况。先来看张图:

Android中Touch 事件的分发和消费机制

上面的图为测试案例的布局文件 UI 显示效果,布局文件代码如下:

Android中Touch 事件的分发和消费机制
<?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>      
Android中Touch 事件的分发和消费机制

蓝色背景为一个自定义控件 TouchEventFather,该控件为外层 View,继承自 LinearLayout,实现代码如下:

Android中Touch 事件的分发和消费机制
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);
    }

}      
Android中Touch 事件的分发和消费机制

红色背景为一个自定义控件 TouchEventChilds,该控件为内层 View,为 TouchEventFather 的子 View,同样继承自 LinearLayout,实现代码如下:

Android中Touch 事件的分发和消费机制
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);
    }

}      
Android中Touch 事件的分发和消费机制

接着实现 Activity 的代码,因为控件所有的事件都是通过 Activity 的 dispatchTouchEvent 进行分发的;除此之外还需要重写 Activity 的 onTouchEvent 方法,这是因为如果一个控件直接从 Activity 获取到事件,这个事件会首先被传递到控件的 dispatchTouchEvent 方法,如果这个方法 return false,事件会以冒泡方式返回给 Activity 的 onTouchEvent 进行消费。实现代码如下:

Android中Touch 事件的分发和消费机制
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);
    }

}      
Android中Touch 事件的分发和消费机制

最后再附上 TouchEventUtil 的代码,TouchEventUtil 中并没有做多少事情,只是将以上 2 个自定义控件中各个方法的 MotionEvent 集中到一个工具类中并将其对应的动作以 String 形式返回,这样处理更便于实时观察控件的事件。代码如下:

Android中Touch 事件的分发和消费机制
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;
    }
    
}      
Android中Touch 事件的分发和消费机制

三、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  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
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_UP
结果分析
代码运行后,事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的dispatchTouchEvent,而该控件的 dispatchTouchEvent 返回 false,表示对获取到的事件停止向下传递,同时也不对该事件进行消费。由于 TouchEventFather 获取的事件直接来自 TouchEventActivity ,则会将事件返回给 TouchEventActivity  的 onTouchEvent 进行消费,最后直接由 TouchEventActivity 来响应手指移动和抬起事件。

  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  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 | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | 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  Text
W 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_DOWN
E 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_DOWN
I 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_DOWN
D 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventFather | onTouchEvent --> ACTION_DOWN
W 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_DOWN
W 05-10 05:34:46.343 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.343 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.423 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.423 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.433 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.433 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.442 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
W 05-10 05:34:46.442 481 cn.sunzn.tevent sunzn   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  Text
W 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_DOWN
E 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_DOWN
I 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_DOWN
E 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_DOWN
I 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventChilds | onInterceptTouchEvent --> ACTION_DOWN
D 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventChilds | onTouchEvent --> ACTION_DOWN
D 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventFather | onTouchEvent --> ACTION_DOWN
W 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_DOWN
W 05-10 06:31:47.652 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.652 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.732 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.732 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.812 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.812 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.892 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
W 05-10 06:31:47.892 512 cn.sunzn.tevent sunzn   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  Text
 W  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_DOWN
 E  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_DOWN
 I  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_DOWN
 E  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_DOWN
 W  05-10 08:11:19.652 574  cn.sunzn.tevent  sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 08:11:19.652 574  cn.sunzn.tevent  sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 I  05-10 08:11:19.652 574  cn.sunzn.tevent  sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_MOVE
E  05-10 08:11:19.652 574 cn.sunzn.tevent sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 08:11:19.872 574 cn.sunzn.tevent  sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
E 05-10 08:11:19.872 574 cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_UP
I 05-10 08:11:19.872 574 cn.sunzn.tevent sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_UP
 E  05-10 08:11:19.872 574 cn.sunzn.tevent  sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_UP
结果分析
代码运行后,事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的 dispatchTouchEvent,该控件的 dispatchTouchEvent 返回super.dispatchTouchEvent(ev),事件会分发到 TouchEventFather 的 onInterceptTouchEvent,onInterceptTouchEvent 返回 false 表示放行当先事件;事件会被传递到子控件 TouchEventChilds 的 dispatchTouchEvent 方法,dispatchTouchEvent 返回 true 表示事件被分发到 TouchEventChilds 控件并由该控件的 dispatchTouchEvent 方法消费。后续的事件也会不断的重复上面的逻辑最终被 TouchEventChilds 的 dispatchTouchEvent 消费。

 四、源码下载

 下载地址:TouchEvent.rar

 五、相关文档

 文档地址:PRE_andevcon_mastering-the-android-touch-system.pdf

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

从这张表中我们可以看到 ViewGroup 和 View 对与 Touch 事件相关的三个方法均能响应,而 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 事件分析

▐ 事件分发:public boolean dispatchTouchEvent(MotionEvent ev)

Touch 事件发生时 Activity 的 dispatchTouchEvent(MotionEvent ev) 方法会以隧道方式(从根元素依次往下传递直到最内层子元素或在中间某一元素中由于某一条件停止传递)将事件传递给最外层 View 的 dispatchTouchEvent(MotionEvent ev) 方法,并由该 View 的 dispatchTouchEvent(MotionEvent ev) 方法对事件进行分发。dispatchTouchEvent 的事件分发逻辑如下:

  • 如果 return true,事件会分发给当前 View 并由 dispatchTouchEvent 方法进行消费,同时事件会停止向下传递;
  • 如果 return false,事件分发分为两种情况:
  1. 如果当前 View 获取的事件直接来自 Activity,则会将事件返回给 Activity 的 onTouchEvent 进行消费;
  2. 如果当前 View 获取的事件来自外层父控件,则会将事件返回给父 View 的  onTouchEvent 进行消费。
  • 如果返回系统默认的 super.dispatchTouchEvent(ev),事件会自动的分发给当前 View 的 onInterceptTouchEvent 方法。

▐ 事件拦截:public boolean 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 进行处理。

▐ 事件响应:public boolean onTouchEvent(MotionEvent ev)

在 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 案例介绍

同样在开始进行案例分析之前,我需要说明测试案例的结构,因为所有的测试都是针对这一个案例来进行的,测试中只是通过修改每个控件中与 Touch 事件相关的三个方法的返回值来体现不同的情况。先来看张图:

Android中Touch 事件的分发和消费机制

上面的图为测试案例的布局文件 UI 显示效果,布局文件代码如下:

Android中Touch 事件的分发和消费机制
<?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>      
Android中Touch 事件的分发和消费机制

蓝色背景为一个自定义控件 TouchEventFather,该控件为外层 View,继承自 LinearLayout,实现代码如下:

Android中Touch 事件的分发和消费机制
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);
    }

}      
Android中Touch 事件的分发和消费机制

红色背景为一个自定义控件 TouchEventChilds,该控件为内层 View,为 TouchEventFather 的子 View,同样继承自 LinearLayout,实现代码如下:

Android中Touch 事件的分发和消费机制
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);
    }

}      
Android中Touch 事件的分发和消费机制

接着实现 Activity 的代码,因为控件所有的事件都是通过 Activity 的 dispatchTouchEvent 进行分发的;除此之外还需要重写 Activity 的 onTouchEvent 方法,这是因为如果一个控件直接从 Activity 获取到事件,这个事件会首先被传递到控件的 dispatchTouchEvent 方法,如果这个方法 return false,事件会以冒泡方式返回给 Activity 的 onTouchEvent 进行消费。实现代码如下:

Android中Touch 事件的分发和消费机制
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);
    }

}      
Android中Touch 事件的分发和消费机制

最后再附上 TouchEventUtil 的代码,TouchEventUtil 中并没有做多少事情,只是将以上 2 个自定义控件中各个方法的 MotionEvent 集中到一个工具类中并将其对应的动作以 String 形式返回,这样处理更便于实时观察控件的事件。代码如下:

Android中Touch 事件的分发和消费机制
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;
    }
    
}      
Android中Touch 事件的分发和消费机制

三、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  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
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_UP
结果分析
代码运行后,事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的dispatchTouchEvent,而该控件的 dispatchTouchEvent 返回 false,表示对获取到的事件停止向下传递,同时也不对该事件进行消费。由于 TouchEventFather 获取的事件直接来自 TouchEventActivity ,则会将事件返回给 TouchEventActivity  的 onTouchEvent 进行消费,最后直接由 TouchEventActivity 来响应手指移动和抬起事件。

  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  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 | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
E  05-10 03:41:19.743  414  cn.sunzn.tevent sunzn   TouchEventFather | 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  Text
W 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_DOWN
E 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_DOWN
I 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_DOWN
D 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventFather | onTouchEvent --> ACTION_DOWN
W 05-10 05:34:46.333 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_DOWN
W 05-10 05:34:46.343 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.343 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.423 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.423 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.433 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.433 481 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 05:34:46.442 481 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
W 05-10 05:34:46.442 481 cn.sunzn.tevent sunzn   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  Text
W 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_DOWN
E 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_DOWN
I 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_DOWN
E 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_DOWN
I 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventChilds | onInterceptTouchEvent --> ACTION_DOWN
D 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventChilds | onTouchEvent --> ACTION_DOWN
D 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventFather | onTouchEvent --> ACTION_DOWN
W 05-10 06:31:47.565 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_DOWN
W 05-10 06:31:47.652 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.652 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.732 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.732 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.812 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.812 512 cn.sunzn.tevent sunzn   TouchEventActivity | onTouchEvent --> ACTION_MOVE
W 05-10 06:31:47.892 512 cn.sunzn.tevent sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
W 05-10 06:31:47.892 512 cn.sunzn.tevent sunzn   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  Text
 W  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_DOWN
 E  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_DOWN
 I  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_DOWN
 E  05-10 08:11:18.403 574  cn.sunzn.tevent  sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_DOWN
 W  05-10 08:11:19.652 574  cn.sunzn.tevent  sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_MOVE
 E  05-10 08:11:19.652 574  cn.sunzn.tevent  sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_MOVE
 I  05-10 08:11:19.652 574  cn.sunzn.tevent  sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_MOVE
E  05-10 08:11:19.652 574 cn.sunzn.tevent sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_MOVE
 W  05-10 08:11:19.872 574 cn.sunzn.tevent  sunzn   TouchEventActivity | dispatchTouchEvent --> ACTION_UP
E 05-10 08:11:19.872 574 cn.sunzn.tevent sunzn   TouchEventFather | dispatchTouchEvent --> ACTION_UP
I 05-10 08:11:19.872 574 cn.sunzn.tevent sunzn   TouchEventFather | onInterceptTouchEvent --> ACTION_UP
 E  05-10 08:11:19.872 574 cn.sunzn.tevent  sunzn   TouchEventChilds | dispatchTouchEvent --> ACTION_UP
结果分析
代码运行后,事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的 dispatchTouchEvent,该控件的 dispatchTouchEvent 返回super.dispatchTouchEvent(ev),事件会分发到 TouchEventFather 的 onInterceptTouchEvent,onInterceptTouchEvent 返回 false 表示放行当先事件;事件会被传递到子控件 TouchEventChilds 的 dispatchTouchEvent 方法,dispatchTouchEvent 返回 true 表示事件被分发到 TouchEventChilds 控件并由该控件的 dispatchTouchEvent 方法消费。后续的事件也会不断的重复上面的逻辑最终被 TouchEventChilds 的 dispatchTouchEvent 消费。

 四、源码下载

 下载地址:TouchEvent.rar

 五、相关文档

 文档地址:PRE_andevcon_mastering-the-android-touch-system.pdf

继续阅读