一、Touch的三个重要方法
在Android中,与触摸事件也就是 Touch 相关的有三个重要方法,这三个方法共同完成触摸事件的分发。
- public boolean dispatchTouchEvent(MotionEvent ev) :事件分发
- public boolean onInterceptTouchEvent(MotionEvent ev):事件拦截
- public boolean onTouchEvent(MotionEvent ev):事件响应
下面就依次来分析这三个方法。
1、事件分发
public boolean dispatchTouchEvent(MotionEvent ev)
顾名思义,事件的分发就是当一个触摸事件发生的时候,会按照Activity -> Window -> View的顺序依次往下传递。也就是说系统会把这个事件传递给一个具体的View,从而来执行或者说响应这个事件。我们来看博客上是如何说明的:
Touch 事件发生时 Activity 的 dispatchTouchEvent(MotionEvent ev) 方法会以隧道方式(从根元素依次往下传递直到最内层子元素或在中间某一元素中由于某一条件停止传递)将事件传递给最外层 View 的 dispatchTouchEvent(MotionEvent ev) 方法,并由该 View 的 dispatchTouchEvent(MotionEvent ev) 方法对事件进行分发。
这里要注意几个地方:
第一触摸事件传递的开始一定是Activity;
第二传递方式是通过隧道方式传递;
第三一直传递到一个最外层的View,也就是顶级View,由该View的这个方法来进行分发。
那么我们不禁有个疑问,那Activity能不能直接分发呢,换句话说,传递过程什么时候终止呢?答案就是通过判断这个方法的返回值来处理分发的逻辑。我们看到,分发方法的返回值是 boolean ,所以返回值有 true 和 false ,再加上一个继承超类的方法 super ,所以一共有三种返回值。
依次来看:
- 如果 return true,事件会分发给当前 View 并由 dispatchTouchEvent 方法进行消费,同时事件会停止向下传递;
- 如果 return false,事件会分发给事件来源Activity或者父级View的 onTouchEvent 进行消费;
- 如果return super.dispatchTouchEvent(ev),事件会自动的分发给当前 View 的 onInterceptTouchEvent 方法。
博客上的这个结论单独拿来看可能有点抽象,我当时看的时候也是,先不急着说清楚,稍后看案例就恍然大悟了。现在只要明白一个概念,事件的分发是按照依次往下的顺序,并根据返回结果,决定由谁进行消费。
2、事件拦截
public boolean onInterceptTouchEvent(MotionEvent ev)
与事件分发不同的是,该方法是在事件分发的 dispatchTouchEvent 方法内部进行调用。是用来判断在触摸事件传递过程中,是否拦截某个事件。博客的解释是这样的:
在外层 View 的 dispatchTouchEvent(MotionEvent ev) 方法返回系统默认的 super.dispatchTouchEvent(ev) 情况下,事件会自动的分发给当前 View 的 onInterceptTouchEvent 方法。
同样的是,该方法仍然通过返回值来判断是否拦截当前事件。
- 如果return true,则表示将事件进行拦截,并将拦截到的事件交由当前 View 的 onTouchEvent 进行处理;
- 如果return false,则表示将事件放行,当前 View 上的事件会被传递到子 View 上,再由子 View 的 dispatchTouchEvent 来开始这个事件的分发;
- 如果return super.onInterceptTouchEvent(ev),事件默认会被拦截,并将拦截到的事件交由当前 View 的 onTouchEvent 进行处理。
当然现在我们也不需要深究是什么意思,只需注意,如果当前的View已经拦截了某一个事件,那么在触摸事件的一整个事件序列中,也就是down -> move -> ... -> up一整个事件中,此方法不会被在调用。
3、事件响应
public boolean onTouchEvent(MotionEvent ev)
这个方法就是用来处理具体点击事件的,它是在dispatchTouchEvent方法中调用,博客是这样说的:
在 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev) 并且 onInterceptTouchEvent 返回 true 或返回 super.onInterceptTouchEvent(ev) 的情况下 onTouchEvent 会被调用。
它的返回值表示是否消费当前事件,也就是是否响应当前事件,具体逻辑如下:
- 如果return true 则会接收并消费该事件。
- 如果return false,那么这个事件会向上传递,并由上层 View 的 onTouchEvent 来接收,如果传递到上面的 onTouchEvent 还是返回 false,这个事件无效,且接收不到下一次事件。
- 如果return super.onTouchEvent(ev) 默认处理事件的逻辑和返回 false 时相同。
值得注意的是,返回结果表示是否消费当前事件,如果不消费的话,那么当前View就无法再次接受到事件。
那么看到这里的话,我相信大家还是没有一个清晰的认识,下面我们就从三者的联系与区别上再次说明。
二、三种方法的区别与联系
1、区别
三者的区别在博客开头已经说明的非常清楚了,我也仿照文章中表格的形式,总结了一个表格。
Touch事件
也就是说,这三个触摸事件相关的方法,Activity、View、ViewGroup及其子类都能够响应。但是Activity对事件拦截不响应。
值得注意的是,如果当前View能够添加子View或者整个View中有多个子View,那么方法都能响应。但是如果当前View本身已经是一个最小View,那就只能够响应onTouchEvent。
原因简单想一下就知道了,事件分发与事件拦截都是由上级往下级传递事件,如果一个View已经是最后一级了,它就无法进行事件分发或事件拦截的必要了。就相当于做汽车,中间站可能会停站进行让乘客上车下车,但是到了终点站你只有下车,这是一样的道理。
2、联系
上面已经说明了三者的区别,那么三者的关系是怎么样的呢?在《Android开发艺术探索》一书中,有这样一串伪代码,就跟书中说明的一样,“已经将三者的关系表现得淋漓尽致”,我们来看这串伪代码:
/**
* @Title: dispatchTouchEvent
* @Description: 三者关系的伪代码
* @return: boolean
*
/
public boolean dispatchTouchEvent(MotionEvent ev){
//默认返回值
boolean consume = false;
//如果事件发生了拦截
if(onInterceptTouchEvent(ev)){
//消费事件
consume = onTouchEvent(ev);
}else{
//否则分发给子View
consume = child.dispatchTouchEvent(ev);
}
//返回值
return consume;
}
用语言来说就是,一旦发生触摸事件,根 View/ViewGroup 会调用 dispatchTouchEvent 方法,如果这个方法返回 false ,触摸事件不生效。但是如果它的 onInterceptTouchEvent 方法返回了true,代表事件被拦截,那么事件就会交给当前View的 onTouchEvent 方法对事件进行消费。但是如果没有拦截呢,那么会继续将事件分发给当前View的子View,子View继续调用 dispatchTouchEvent 方法,如此循环,直到事件被消费。
但是需要注意的是,我们需要考虑另外一种情况,那就是最终的View的 onTouchEvent 方法仍然返回了false,那么此时,它的父View的 onTouchEvent 方法将会被调用,如果父View仍然没有消费该事件,那么就继续往上级传递,直到传到最后的Activity调用 onTouchEvent 方法。
这就跟我们之前的返回值一一对应了起来,现在回头看看,应该能对事件分发有了一个比较清晰的概念。好吧,如果还是没有概念,我们只能上图了。图也是黑马教程中的图,我优化了一下,看的更加清晰。
事件消费
至此,我们理论上的东西基本已经讲完了,现在我们就通过一个例子来说明具体的事件分发情况。
三、案例分析
1、案例说明
文章开头已经说过了,没有更好的例子能说明这个问题了。我将类的结构稍微更改了一下,内容不变。
先自定义两个View继承 LinearLayout ,其中为 TouchEventFather 为父View ,TouchEventChilds 为子View。
/**
* @ClassName: TouchEventFather
* @Description:父View
* @author: [email protected]
* @date: 2016年5月9日 下午9:54:14
*/
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);
// return false;
}
public boolean onInterceptTouchEvent(MotionEvent ev) {
Log.i("sunzn", "TouchEventFather | onInterceptTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
return super.onInterceptTouchEvent(ev);
// return false;
}
public boolean onTouchEvent(MotionEvent ev) {
Log.d("sunzn", "TouchEventFather | onTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
return super.onTouchEvent(ev);
}
}
/**
* @ClassName: TouchEventFather
* @Description:子View
* @author: [email protected]
* @date: 2016年5月9日 下午9:54:14
*/
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);
// return false;
}
public boolean onInterceptTouchEvent(MotionEvent ev) {
Log.i("sunzn", "TouchEventChilds | onInterceptTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
return super.onInterceptTouchEvent(ev);
// return false;
}
public boolean onTouchEvent(MotionEvent ev) {
Log.d("sunzn", "TouchEventChilds | onTouchEvent --> " + TouchEventUtil.getTouchAction(ev.getAction()));
return super.onTouchEvent(ev);
}
}
定义好这两个自定义布局后,我们可以在布局文件中设置布局,注意一定要写自定义布局的完整包名。
<xml version="1.0" encoding="utf-8"?>
<cn.sunzn.tevent.view.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.view.TouchEventChilds
android:id="@+id/childs"
android:layout_width="200dp"
android:layout_height="200dp"
android:layout_gravity="center"
android:background="#E1110D" />
</cn.sunzn.tevent.view.TouchEventFather>
接下来就是主Activity:
/**
* @ClassName: TouchEventActivity
* @Description:事件分发机制详解
* @author: [email protected]
* @date: 2016年5月9日 下午9:53:27
*/
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);
}
}
最后是一个工具类,只是将各个点击状态封装到一个方法中:
/**
* @ClassName: TouchEventUtil
* @Description:点击事件工具类
* @author: [email protected]
* @date: 2016年5月9日 下午9:53:51
*/
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;
}
}
好了,代码介绍完了,部署到手机上的时候,应该是这个样子。
事件分发案例
我们现在就通过不同的返回值,来具体看事件分发的过程,注意我们将代码部署到手机上的时候,默认做的动作是点击中间红色部分一下,这样更能直观的观察日志情况。另外由于原博主总结的非常好,这里我就直接截图过来,然后具体说明一下。
2、情况一
case1
过程及结果分析:
- 事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的dispatchTouchEvent;
- 而该TouchEventFather 控件的 dispatchTouchEvent 返回 false,表示对获取到的事件停止向下传递,同时也不对该事件进行消费;
- 由于 TouchEventFather 获取的事件直接来自 TouchEventActivity ,则会将事件返回给 TouchEventActivity 的 onTouchEvent 进行消费;
- 最后直接由 TouchEventActivity 来响应手指移动和抬起事件。
3、情况二
case2
过程及结果分析:
- 事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的 dispatchTouchEvent;
- 而该TouchEventFather 控件的 dispatchTouchEvent 返回 true,表示分发事件到 TouchEventFather 控件并由该控件的 dispatchTouchEvent 进行消费;
- 又因为TouchEventActivity 不断的分发事件到 TouchEventFather 控件的 dispatchTouchEvent,而 TouchEventFather 控件的 dispatchTouchEvent 也不断的将获取到的事件进行消费。
4、情况三
case3
过程及结果分析:
- 事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的 dispatchTouchEvent;
- 而该TouchEventFather 控件的 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev),表示对事件进行分发并向下传递给 TouchEventFather 控件的 onInterceptTouchEvent 方法;
- 而该方法返回 true 表示对所获取到的事件进行拦截并将事件传递给 TouchEventFather 控件的 onTouchEvent 进行处理,TouchEventFather 控件的 onTouchEvent 返回 super.onTouchEvent(ev) 表示对事件没有做任何处理直接将事件返回给上级控件;
- 由于 TouchEventFather 获取的事件直接来自 TouchEventActivity,所以 TouchEventFather 控件的 onTouchEvent 会将事件以冒泡方式直接返回给 TouchEventActivity 的 onTouchEvent 进行消费;
- 后续的事件则会跳过 TouchEventFather 直接由 TouchEventActivity 的 onTouchEvent 消费来自 TouchEventActivity 自身分发的事件。
5、情况四
case4
过程及结果分析:
- 事件首先由 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 自身分发的事件。
6、情况五
case5
过程及结果分析:
- 事件首先由 TouchEventActivity 的 dispatchTouchEvent 方法分发给 TouchEventFather 控件的 dispatchTouchEvent;
- 该控件的 dispatchTouchEvent 返回 super.dispatchTouchEvent(ev),事件会分发到 TouchEventFather 的 onInterceptTouchEvent,此方法返回 false 表示放行当先事件;
- 事件会被传递到子控件 TouchEventChilds 的 dispatchTouchEvent 方法,dispatchTouchEvent 返回 true 表示事件被分发到 TouchEventChilds ,并由 dispatchTouchEvent 方法消费;
- 后续的事件也会不断的重复上面的逻辑最终被 TouchEventChilds 的 dispatchTouchEvent 消费。
四、总结与归纳
好了,看完理论与代码结果,我想应该已经够直观的说明事件分发机制了。虽然在实际开发过程还是会遇到各种各样的问题,但是有了理论基础,处理起来应该不会太难。接下来我就总结一下一些比较重要的注意事项和结论。有些是书上的重要结论。
如果在你不知道返回什么的情况下,记住如果是完全自定义View就返回true,如果是继承已有的控件或者View那就返回super;
正常情况下,一个事件序列只能被一个View拦截,这是肯定的,因为某个事件被拦截后,只能通过这个拦截View来处理。当然前提是正常情况下。
View没有onInterceptTouchEvent方法,只要有触摸事件会直接调用onTouchEvent方法。
如果一个View设置了OnTouchListener方法,那么会优先调用onTouch方法,这个时候还要看onTouch方法的返回值,如果为false那么继续调用onTouchEvent方法,如果为true则不调用。
如果onTouchEvent方法里面设置了OnClickListener之类的方法,它会在onTouchEvent方法调用之后调用其中的onClick方法。
一个事件一旦交给了一个View进行处理,那么它必须消费掉事件,否则剩下的事件序列将不再由其处理。
1.三个主要相关的方法的默认值
所有dispatchTouchEvent方法的默认值都是false。
ViewGroup里的onInterceptTouchEvent默认值是false这样才能把事件传给View里的onTouchEvent.
Activity和ViewGroup里的onTouchEvent默认值都是false。
View里的onTouchEvent返回默认值是true.这样才能执行多次touch事件。
2.TouchEvent的处理流程
当TouchEvent发生时,首先Activity将TouchEvent传递给最顶层的View, TouchEvent最先到达最顶层 view 的 dispatchTouchEvent ,然后由 dispatchTouchEvent 方法进行分发,如果dispatchTouchEvent返回true ,则表示该触摸事件已经被消费了,如果dispatchTouchEvent返回 false
,则交给这个 view 的 interceptTouchEvent 方法来决定是否要拦截这个事件,如果 interceptTouchEvent 返回 true ,也就是拦截掉了,则交给它的 onTouchEvent 来处理,如果 interceptTouchEvent 返回 false ,那么就传递给子 view ,由子 view 的 dispatchTouchEvent 再来开始这个事件的分发。如果事件传递到某一层的子 view 的 onTouchEvent 上了,这个方法返回了 false ,那么这个事件会从这个
view 往上传递,都是 onTouchEvent 来接收。而如果传递到最上面的 onTouchEvent 也返回 false 的话,这个事件就会“ 消失”,而且接收不到下一次事件。
3.TouchEvent的处理流程图
自己制作了个TouchEvent处理的流程图,方便理清TouchEvent事件在各种UI对象以及对应方法中的处理机制。将流程图与上面的运行日志结合分析,发现对TouchEvent处理的机制清晰了很多。若有错误之处,欢迎指教。