Android事件分发机制详解:史上最全面、最易懂


前言

  • Android事件分发机制是Android开发者必须了解的基础
  • 网上有大量关于Android事件分发机制的文章,但存在一些问题:内容不全、思路不清晰、无源码分析、简单问题复杂化等等
  • 今天,我将全面总结Android的事件分发机制,我能保证这是市面上的最全面、最清晰、最易懂的
    1. 本文秉着“结论先行、详细分析在后”的原则,即先让大家感性认识,再通过理性分析从而理解问题;
    2. 所以,请各位读者先记住结论,再往下继续看分析;
  • 文章较长,阅读需要较长时间,建议收藏等充足时间再进行阅读

目录

目录

1. 基础认知

1.1 事件分发的对象是谁?

答:事件

  • 当用户触摸屏幕时(View或ViewGroup派生的控件),将产生点击事件(Touch事件)。

    Touch事件相关细节(发生触摸的位置、时间、历史记录、手势动作等)被封装成MotionEvent对象

  • 主要发生的Touch事件有如下四种:

    • MotionEvent.ACTION_DOWN:按下View(所有事件的开始)
    • MotionEvent.ACTION_MOVE:滑动View
    • MotionEvent.ACTION_CANCEL:非人为原因结束本次事件
    • MotionEvent.ACTION_UP:抬起View(与DOWN对应)
  • 事件列:从手指接触屏幕至手指离开屏幕,这个过程产生的一系列事件 任何事件列都是以DOWN事件开始,UP事件结束,中间有无数的MOVE事件,如下图:

    事件列

即当一个MotionEvent 产生后,系统需要把这个事件传递给一个具体的 View 去处理,

1.2 事件分发的本质

答:将点击事件(MotionEvent)向某个View进行传递并最终得到处理

即当一个点击事件发生后,系统需要将这个事件传递给一个具体的View去处理。这个事件传递的过程就是分发过程。

1.3 事件在哪些对象之间进行传递?

答:Activity、ViewGroup、View

一个点击事件产生后,传递顺序是:Activity(Window) -> ViewGroup -> View

  • Android的UI界面是由Activity、ViewGroup、View及其派生类组合而成的
    UI界面
  • View是所有UI组件的基类

    一般Button、ImageView、TextView等控件都是继承父类View

  • ViewGroup是容纳UI组件的容器,即一组View的集合(包含很多子View和子VewGroup),

    1. 其本身也是从View派生的,即ViewGroup是View的子类
    2. 是Android所有布局的父类或间接父类:项目用到的布局(LinearLayout、RelativeLayout等),都继承自ViewGroup,即属于ViewGroup子类。
    3. 与普通View的区别:ViewGroup实际上也是一个View,只不过比起View,它多了可以包含子View和定义布局参数的功能。

1.4 事件分发过程由哪些方法协作完成?

答:dispatchTouchEvent() 、onInterceptTouchEvent()和onTouchEvent()

事件分发相关方法

下文会对这3个方法进行详细介绍

1.5 总结

  • Android事件分发机制的本质是要解决:点击事件由哪个对象发出,经过哪些对象,最终达到哪个对象并最终得到处理。

    这里的对象是指Activity、ViewGroup、View

  • Android中事件分发顺序:Activity(Window) -> ViewGroup -> View
  • 事件分发过程由dispatchTouchEvent() 、onInterceptTouchEvent()和onTouchEvent()三个方法协助完成

经过上述3个问题,相信大家已经对Android的事件分发有了感性的认知,接下来,我将详细介绍Android事件分发机制。


2. 事件分发机制方法&流程介绍

  • 事件分发过程由dispatchTouchEvent() 、onInterceptTouchEvent()和onTouchEvent()三个方法协助完成,如下图:
方法详细介绍
  • Android事件分发流程如下:(必须熟记

    Android事件分发顺序:Activity(Window) -> ViewGroup -> View

事件分发机制详细流程

其中:

  • super:调用父类方法
  • true:消费事件,即事件不继续往下传递
  • false:不消费事件,事件也不继续往下传递 / 交由给父控件onTouchEvent()处理

接下来,我将详细介绍这3个方法及相关流程。

2.1 dispatchTouchEvent()

属性 介绍
使用对象 Activity、ViewGroup、View
作用 分发点击事件
调用时刻 当点击事件能够传递给当前View时,该方法就会被调用
返回结果 是否消费当前事件,详细情况如下:

1. 默认情况:根据当前对象的不同而返回方法不同

对象 返回方法 备注
Activity super.dispatchTouchEvent() 即调用父类ViewGroup的dispatchTouchEvent()
ViewGroup onIntercepTouchEvent() 即调用自身的onIntercepTouchEvent()
View onTouchEvent() 即调用自身的onTouchEvent()
流程解析

2. 返回true

  • 消费事件
  • 事件不会往下传递
  • 后续事件(Move、Up)会继续分发到该View
  • 流程图如下:
流程图

3. 返回false

  • 不消费事件
  • 事件不会往下传递
  • 将事件回传给父控件的onTouchEvent()处理

    Activity例外:返回false=消费事件

  • 后续事件(Move、Up)会继续分发到该View(与onTouchEvent()区别)
  • 流程图如下:
    流程图

2.2 onTouchEvent()

属性 介绍
使用对象 Activity、ViewGroup、View
作用 处理点击事件
调用时刻 在dispatchTouchEvent()内部调用
返回结果 是否消费(处理)当前事件,详细情况如下:

与dispatchTouchEvent()类似

1. 返回true

  • 自己处理(消费)该事情
  • 事件停止传递
  • 该事件序列的后续事件(Move、Up)让其处理;
  • 流程图如下:
    流程图

2. 返回false(同默认实现:调用父类onTouchEvent())

  • 不处理(消费)该事件
  • 事件往上传递给父控件的onTouchEvent()处理
  • 当前View不再接受此事件列的其他事件(Move、Up);
  • 流程图如下:
    流程图

2.3 onInterceptTouchEvent()

属性 介绍
使用对象 ViewGroup(注:Activity、View都没该方法)
作用 拦截事件,即自己处理该事件
调用时刻 在ViewGroup的dispatchTouchEvent()内部调用
返回结果 是否拦截当前事件,详细情况如下:
返回结果
  • 流程图如下:
流程图

2.4 三者关系

下面将用一段伪代码来阐述上述三个方法的关系和点击事件传递规则

  1. // 点击事件产生后,会直接调用dispatchTouchEvent()方法
  2. public boolean dispatchTouchEvent(MotionEvent ev) {
  3.  
  4. //代表是否消耗事件
  5. boolean consume = false;
  6.  
  7.  
  8. if (onInterceptTouchEvent(ev)) {
  9. //如果onInterceptTouchEvent()返回true则代表当前View拦截了点击事件
  10. //则该点击事件则会交给当前View进行处理
  11. //即调用onTouchEvent ()方法去处理点击事件
  12. consume = onTouchEvent (ev) ;
  13.  
  14. } else {
  15. //如果onInterceptTouchEvent()返回false则代表当前View不拦截点击事件
  16. //则该点击事件则会继续传递给它的子元素
  17. //子元素的dispatchTouchEvent()就会被调用,重复上述过程
  18. //直到点击事件被最终处理为止
  19. consume = child.dispatchTouchEvent (ev) ;
  20. }
  21.  
  22. return consume;
  23. }

2.5 总结

  • 对于事件分发的3个方法,你应该清楚了解
  • 接下来,我将开始介绍Android事件分发的常见流程

3. 事件分发场景介绍

下面我将利用例子来说明常见的点击事件传递情况

3.1 背景描述

我们将要讨论的布局层次如下:


布局层次
  • 最外层:Activiy A,包含两个子View:ViewGroup B、View C
  • 中间层:ViewGroup B,包含一个子View:View C
  • 最内层:View C

假设用户首先触摸到屏幕上View C上的某个点(如图中黄色区域),那么Action_DOWN事件就在该点产生,然后用户移动手指并最后离开屏幕。

3.2 一般的事件传递情况

一般的事件传递场景有:

  • 默认情况
  • 处理事件
  • 拦截DOWN事件
  • 拦截后续事件(MOVE、UP)

3.2.1 默认情况

  • 即不对控件里的方法(dispatchTouchEvent()、onTouchEvent()、onInterceptTouchEvent())进行重写或更改返回值
  • 那么调用的是这3个方法的默认实现:调用父类的方法
  • 事件传递情况:(如图下所示)
    • 从Activity A---->ViewGroup B--->View C,从上往下调用dispatchTouchEvent()
    • 再由View C--->ViewGroup B --->Activity A,从下往上调用onTouchEvent()

流程图

注:虽然ViewGroup B的onInterceptTouchEvent方法对DOWN事件返回了false,后续的事件(MOVE、UP)依然会传递给它的onInterceptTouchEvent()

这一点与onTouchEvent的行为是不一样的。

3.2.2 处理事件

假设View C希望处理这个点击事件,即C被设置成可点击的(Clickable)或者覆写了C的onTouchEvent方法返回true。

最常见的:设置Button按钮来响应点击事件

事件传递情况:(如下图)

  • DOWN事件被传递给C的onTouchEvent方法,该方法返回true,表示处理这个事件
  • 因为C正在处理这个事件,那么DOWN事件将不再往上传递给B和A的onTouchEvent();
  • 该事件列的其他事件(Move、Up)也将传递给C的onTouchEvent()

流程图

3.2.3 拦截DOWN事件

假设ViewGroup B希望处理这个点击事件,即B覆写了onInterceptTouchEvent()返回true、onTouchEvent()返回true。
事件传递情况:(如下图)

  • DOWN事件被传递给B的onInterceptTouchEvent()方法,该方法返回true,表示拦截这个事件,即自己处理这个事件(不再往下传递)
  • 调用onTouchEvent()处理事件(DOWN事件将不再往上传递给A的onTouchEvent())

  • 该事件列的其他事件(Move、Up)将直接传递给B的onTouchEvent()

    该事件列的其他事件(Move、Up)将不会再传递给B的onInterceptTouchEvent方法,该方法一旦返回一次true,就再也不会被调用了。


流程图

3.2.4 拦截DOWN的后续事件

假设ViewGroup B没有拦截DOWN事件(还是View C来处理DOWN事件),但它拦截了接下来的MOVE事件。

  • DOWN事件传递到C的onTouchEvent方法,返回了true。
  • 在后续到来的MOVE事件,B的onInterceptTouchEvent方法返回true拦截该MOVE事件,但该事件并没有传递给B;这个MOVE事件将会被系统变成一个CANCEL事件传递给C的onTouchEvent方法
  • 后续又来了一个MOVE事件,该MOVE事件才会直接传递给B的onTouchEvent()

    1. 后续事件将直接传递给B的onTouchEvent()处理
    2. 后续事件将不会再传递给B的onInterceptTouchEvent方法,该方法一旦返回一次true,就再也不会被调用了。
  • C再也不会收到该事件列产生的后续事件。


    流程图

特别注意:

  • 如果ViewGroup A 拦截了一个半路的事件(如MOVE),这个事件将会被系统变成一个CANCEL事件并传递给之前处理该事件的子View;
  • 该事件不会再传递给ViewGroup A的onTouchEvent()
  • 只有再到来的事件才会传递到ViewGroup A的onTouchEvent()

3.3 总结

  • 对于Android的事件分发机制,你应该已经非常清楚了
  • 如果你只是希望了解Android事件分发机制而不想深入了解,那么你可以离开这篇文章了
  • 对于程序猿来说,知其然还需要知其所以然,接下来,我将通过源码分析来深入了解Android事件分发机制

4. Android事件分发机制源码分析

  • Android中事件分发顺序:Activity(Window) -> ViewGroup -> View,再次贴出下图:

事件分发机制详细流程

其中:

  • super:调用父类方法
  • true:消费事件,即事件不继续往下传递
  • false:不消费事件,事件继续往下传递 / 交由给父控件onTouchEvent()处理

所以,要想充分理解Android分发机制,本质上是要理解:

  • Activity对点击事件的分发机制
  • ViewGroup对点击事件的分发机制
  • View对点击事件的分发机制

接下来,我将通过源码分析详细介绍Activity、View和ViewGroup的事件分发机制


4.1 Activity的事件分发机制

4.1.1 源码分析

  • 当一个点击事件发生时,事件最先传到Activity的dispatchTouchEvent()进行事件分发

    具体是由Activity的Window来完成

  • 我们来看下Activity的dispatchTouchEvent()的源码
  1. public boolean dispatchTouchEvent(MotionEvent ev) {
  2. //关注点1
  3. //一般事件列开始都是DOWN,所以这里基本是true
  4. if (ev.getAction() == MotionEvent.ACTION_DOWN) {
  5. //关注点2
  6. onUserInteraction();
  7. }
  8. //关注点3
  9. if (getWindow().superDispatchTouchEvent(ev)) {
  10. return true;
  11. }
  12. return onTouchEvent(ev);
  13. }

关注点1
一般事件列开始都是DOWN(按下按钮),所以这里返回true,执行onUserInteraction()

关注点2
先来看下onUserInteraction()源码

  1. /**
  2. * Called whenever a key, touch, or trackball event is dispatched to the
  3. * activity. Implement this method if you wish to know that the user has
  4. * interacted with the device in some way while your activity is running.
  5. * This callback and {@link #onUserLeaveHint} are intended to help
  6. * activities manage status bar notifications intelligently; specifically,
  7. * for helping activities determine the proper time to cancel a notfication.
  8. *
  9. * <p>All calls to your activity's {@link #onUserLeaveHint} callback will
  10. * be accompanied by calls to {@link #onUserInteraction}. This
  11. * ensures that your activity will be told of relevant user activity such
  12. * as pulling down the notification pane and touching an item there.
  13. *
  14. * <p>Note that this callback will be invoked for the touch down action
  15. * that begins a touch gesture, but may not be invoked for the touch-moved
  16. * and touch-up actions that follow.
  17. *
  18. * @see #onUserLeaveHint()
  19. */
  20. public void onUserInteraction() {
  21. }

从源码可以看出:

  • 该方法为空方法
  • 从注释得知:当此activity在栈顶时,触屏点击按home,back,menu键等都会触发此方法
  • 所以onUserInteraction()主要用于屏保

关注点3

  • Window类是抽象类,且PhoneWindow是Window类的唯一实现类
  • superDispatchTouchEvent(ev)是抽象方法,返回的是一个Window对象
  • 通过PhoneWindow类中看一下superDispatchTouchEvent()的作用
    1. @Override
    2. public boolean superDispatchTouchEvent(MotionEvent event) {
    3. return mDecor.superDispatchTouchEvent(event);
    4. //mDecor是DecorView的实例
    5. //DecorView是视图的顶层view,继承自FrameLayout,是所有界面的父类
    6. }
  • 接下来我们看mDecor.superDispatchTouchEvent(event):
  1. public boolean superDispatchTouchEvent(MotionEvent event) {
  2. return super.dispatchTouchEvent(event);
  3. //DecorView继承自FrameLayout
  4. //那么它的父类就是ViewGroup
  5. super.dispatchTouchEvent(event)方法,其实就应该是ViewGroup的dispatchTouchEvent()
  6.  
  7. }

所以:

  • 执行getWindow().superDispatchTouchEvent(ev)实际上是执行了ViewGroup.dispatchTouchEvent(event)
  • 再回到最初的代码:

    1. public boolean dispatchTouchEvent(MotionEvent ev) {
    2.  
    3. if (ev.getAction() == MotionEvent.ACTION_DOWN) {
    4. //关注点2
    5. onUserInteraction();
    6. }
    7. //关注点3
    8. if (getWindow().superDispatchTouchEvent(ev)) {
    9. return true;
    10. }
    11. return onTouchEvent(ev);
    12. }

    由于一般事件列开始都是DOWN,所以这里返回true,基本上都会进入getWindow().superDispatchTouchEvent(ev)的判断

  • 所以,执行Activity.dispatchTouchEvent(ev)实际上是执行了ViewGroup.dispatchTouchEvent(event)
  • 这样事件就从 Activity 传递到了 ViewGroup

4.1.2 汇总

当一个点击事件发生时,调用顺序如下

  1. 事件最先传到Activity的dispatchTouchEvent()进行事件分发
  2. 调用Window类实现类PhoneWindow的superDispatchTouchEvent()
  3. 调用DecorView的superDispatchTouchEvent()
  4. 最终调用DecorView父类的dispatchTouchEvent(),即ViewGroup的dispatchTouchEvent()

4.1.3 结论

  • 当一个点击事件发生时,事件最先传到Activity的dispatchTouchEvent()进行事件分发,最终是调用了ViewGroup的dispatchTouchEvent()方法

    如果ViewGroup的dispatchTouchEvent()返回true就不执行Activity的onTouchEvent()方法;如果返回false,就执行。

  • 这样事件就从 Activity 传递到了 ViewGroup

4.1.4 疑问

那么,ViewGroup的dispatchTouchEvent()什么时候返回true,什么时候返回false?
答:请继续往下看ViewGroup事件的分发机制


4.2 ViewGroup事件的分发机制

在讲解ViewGroup事件的分发机制之前我们先来看个Demo

4.2.1 Demo讲解

布局如下:


布局层次

结果测试:
只点击Button


只点击Button


再点击空白处


点击空白处

从上面的测试结果发现:

  • 当点击Button时,执行Button的onClick(),但ViewGroupLayout注册的onTouch()不会执行
  • 只有点击空白区域时才会执行ViewGroupLayout的onTouch();
  • 结论:Button的onClick()将事件消费掉了,因此事件不会再继续向下传递。

接下来,我们开始进行ViewGroup事件分发的源码分析

4.2.2 源码分析

ViewGroup的dispatchTouchEvent()源码分析

  1. 详情请看注释
  2. Android 5.0后ViewGroup的dispatchTouchEvent()的源码发生了变化(更加复杂),但原理相同;
  3. 本文为了让读者更好理解dispatchTouchEvent()源码分析,所以采用Android 5.0前的版本
  1. public boolean dispatchTouchEvent(MotionEvent ev) {
  2. final int action = ev.getAction();
  3. final float xf = ev.getX();
  4. final float yf = ev.getY();
  5. final float scrolledXFloat = xf + mScrollX;
  6. final float scrolledYFloat = yf + mScrollY;
  7. final Rect frame = mTempRect;
  8. boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
  9. if (action == MotionEvent.ACTION_DOWN) {
  10. if (mMotionTarget != null) {
  11. mMotionTarget = null;
  12. }
  13.  
  14. //看这个If判断语句
  15. //第一个判断值disallowIntercept:是否禁用事件拦截的功能(默认是false)
  16. //可以通过调用requestDisallowInterceptTouchEvent方法对这个值进行修改。
  17. //第二个判断值: !onInterceptTouchEvent(ev):对onInterceptTouchEvent()返回值取反
  18.  
  19. //如果我们在onInterceptTouchEvent()中返回false,就会让第二个值为true,从而进入到条件判断的内部
  20. //如果我们在onInterceptTouchEvent()中返回true,就会让第二个值为false,从而跳出了这个条件判断。
  21. //关于onInterceptTouchEvent()请看下面分析(关注点1)
  22. if (disallowIntercept || !onInterceptTouchEvent(ev)) {
  23. ev.setAction(MotionEvent.ACTION_DOWN);
  24. final int scrolledXInt = (int) scrolledXFloat;
  25. final int scrolledYInt = (int) scrolledYFloat;
  26. final View[] children = mChildren;
  27. final int count = mChildrenCount;
  28.  
  29. //通过for循环,遍历了当前ViewGroup下的所有子View
  30. for (int i = count - 1; i >= 0; i--) {
  31. final View child = children[i];
  32. if ((child.mViewFlags & VISIBILITY_MASK) == VISIBLE
  33. || child.getAnimation() != null) {
  34. child.getHitRect(frame);
  35.  
  36. //判断当前遍历的View是不是正在点击的View
  37. //如果是,则进入条件判断内部
  38. if (frame.contains(scrolledXInt, scrolledYInt)) {
  39. final float xc = scrolledXFloat - child.mLeft;
  40. final float yc = scrolledYFloat - child.mTop;
  41. ev.setLocation(xc, yc);
  42. child.mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;
  43.  
  44. //关注点2
  45.  
  46. //条件判断的内部调用了该View的dispatchTouchEvent()方法(具体请看下面的View事件分发机制)
  47. //实现了点击事件从ViewGroup到View的传递
  48. if (child.dispatchTouchEvent(ev)) {
  49.  
  50. //调用子View的dispatchTouchEvent后是有返回值的
  51. //如果这个控件是可点击的话,那么点击该控件时,dispatchTouchEvent的返回值必定是true
  52. //因此会导致条件判断成立
  53. mMotionTarget = child;
  54. //于是给ViewGroup的dispatchTouchEvent方法直接返回了true,这样就导致后面的代码无法执行,直接跳出
  55. //即把ViewGroup的touch事件拦截掉
  56. return true;
  57. }
  58. }
  59. }
  60. }
  61. }
  62. }
  63. boolean isUpOrCancel = (action == MotionEvent.ACTION_UP) ||
  64. (action == MotionEvent.ACTION_CANCEL);
  65. if (isUpOrCancel) {
  66. mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT;
  67. }
  68. final View target = mMotionTarget;
  69.  
  70. //关注点3
  71. //没有任何View接收事件的情况,即点击空白处情况
  72. if (target == null) {
  73. ev.setLocation(xf, yf);
  74. if ((mPrivateFlags & CANCEL_NEXT_UP_EVENT) != 0) {
  75. ev.setAction(MotionEvent.ACTION_CANCEL);
  76. mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;
  77. }
  78. //调用ViewGroup的父类View的dispatchTouchEvent()
  79. //因此会执行ViewGroup的onTouch()、onTouchEvent()
  80. //实现了点击事件从ViewGroup到View的传递
  81. return super.dispatchTouchEvent(ev);
  82. }
  83.  
  84.  
  85. //之后的代码在一般情况下是走不到的了,我们也就不再继续往下分析。
  86. if (!disallowIntercept && onInterceptTouchEvent(ev)) {
  87. final float xc = scrolledXFloat - (float) target.mLeft;
  88. final float yc = scrolledYFloat - (float) target.mTop;
  89. mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;
  90. ev.setAction(MotionEvent.ACTION_CANCEL);
  91. ev.setLocation(xc, yc);
  92. if (!target.dispatchTouchEvent(ev)) {
  93. }
  94. mMotionTarget = null;
  95. return true;
  96. }
  97. if (isUpOrCancel) {
  98. mMotionTarget = null;
  99. }
  100. final float xc = scrolledXFloat - (float) target.mLeft;
  101. final float yc = scrolledYFloat - (float) target.mTop;
  102. ev.setLocation(xc, yc);
  103. if ((target.mPrivateFlags & CANCEL_NEXT_UP_EVENT) != 0) {
  104. ev.setAction(MotionEvent.ACTION_CANCEL);
  105. target.mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;
  106. mMotionTarget = null;
  107. }
  108. return target.dispatchTouchEvent(ev);
  109. }

关注点1(onInterceptTouchEvent()源码分析)

ViewGroup每次在做分发时,需要调用onInterceptTouchEvent()是否拦截事件;源码分析如下:

  1. public boolean onInterceptTouchEvent(MotionEvent ev) {
  2. return false;
  3. }
  • 返回false =不拦截(默认),允许事件继续往下传递(向子View传递);

    因为子View也需要该事件,所以onInterceptTouchEvent拦截器return super.onInterceptTouchEvent()和return false是一样的 = 不会拦截

  • 返回true = 拦截(手动设置),即自己处理该事件(执行自己的onTouchEvent()),事件不会继续往下传递

关注点2

当点击了某个控件:

  1. 调用该控件所在布局(ViewGroup)的dispatchTouchEvent()
  2. 在布局的dispatchTouchEvent()中找到被点击的相应控件
  3. 再去调用该控件的dispatchTouchEvent()
    1. 实现了点击事件从ViewGroup到View的传递
    2. 此处是关于View.dispatchTouchEvent()的分析,详情请看下面的View事件分发机制。

结论

  • Android事件分发是先传递到ViewGroup,再由ViewGroup传递到View
  • 在ViewGroup中通过onInterceptTouchEvent()对事件传递进行拦截
    1. onInterceptTouchEvent方法返回true代表拦截事件,即不允许事件继续向子View传递;
    2. 返回false代表不拦截事件,即允许事件继续向子View传递;(默认返回false)
    3. 子View中如果将传递的事件消费掉,ViewGroup中将无法接收到任何事件。


4.3 View事件的分发机制

View中dispatchTouchEvent()的源码分析

  1. public boolean dispatchTouchEvent(MotionEvent event) {
  2. if (mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED &&
  3. mOnTouchListener.onTouch( this, event)) {
  4. return true;
  5. }
  6. return onTouchEvent(event);
  7. }

从上面可以看出:

  • 只有以下三个条件都为真,dispatchTouchEvent()才返回true;否则执行onTouchEvent(event)方法

    1. 第一个条件:mOnTouchListener != null;
    2. 第二个条件:(mViewFlags & ENABLED_MASK) == ENABLED;
    3. 第三个条件:mOnTouchListener.onTouch( this, event);
  • 下面,我们来看看下这三个判断条件:

第一个条件:mOnTouchListener!= null

  1. //mOnTouchListener是在View类下setOnTouchListener方法里赋值的
  2. public void setOnTouchListener(OnTouchListener l) {
  3.  
  4. //即只要我们给控件注册了Touch事件,mOnTouchListener就一定被赋值(不为空)
  5. mOnTouchListener = l;
  6. }

第二个条件:(mViewFlags & ENABLED_MASK) == ENABLED

  • 该条件是判断当前点击的控件是否enable
  • 由于很多View默认是enable的,因此该条件恒定为true

第三个条件:mOnTouchListener.onTouch(this, event)

  • 回调控件注册Touch事件时的onTouch方法

    1. //手动调用设置
    2. button.setOnTouchListener( new OnTouchListener() {
    3.  
    4. @Override
    5. public boolean onTouch(View v, MotionEvent event) {
    6.  
    7. return false;
    8. }
    9. });
  • 如果在onTouch方法返回true,就会让上述三个条件全部成立,从而整个方法直接返回true。
  • 如果在onTouch方法里返回false,就会去执行onTouchEvent(event)方法。

接下来,我们继续看:onTouchEvent(event)的源码分析

  1. 详情请看注释
  2. Android 5.0后View的onTouchEvent()的源码发生了变化(更加复杂),但原理相同;
  3. 本文为了让读者更好理解onTouchEvent()源码分析,所以采用Android 5.0前的版本
  1. public boolean onTouchEvent(MotionEvent event) {
  2. final int viewFlags = mViewFlags;
  3. if ((viewFlags & ENABLED_MASK) == DISABLED) {
  4. // A disabled view that is clickable still consumes the touch
  5. // events, it just doesn't respond to them.
  6. return (((viewFlags & CLICKABLE) == CLICKABLE ||
  7. (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE));
  8. }
  9. if (mTouchDelegate != null) {
  10. if (mTouchDelegate.onTouchEvent(event)) {
  11. return true;
  12. }
  13. }
  14. //如果该控件是可以点击的就会进入到下两行的switch判断中去;
  15.  
  16. if (((viewFlags & CLICKABLE) == CLICKABLE ||
  17. (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) {
  18. //如果当前的事件是抬起手指,则会进入到MotionEvent.ACTION_UP这个case当中。
  19.  
  20. switch (event.getAction()) {
  21. case MotionEvent.ACTION_UP:
  22. boolean prepressed = (mPrivateFlags & PREPRESSED) != 0;
  23. // 在经过种种判断之后,会执行到关注点1的performClick()方法。
  24. //请往下看关注点1
  25. if ((mPrivateFlags & PRESSED) != 0 || prepressed) {
  26. // take focus if we don't have it already and we should in
  27. // touch mode.
  28. boolean focusTaken = false;
  29. if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
  30. focusTaken = requestFocus();
  31. }
  32. if (!mHasPerformedLongPress) {
  33. // This is a tap, so remove the longpress check
  34. removeLongPressCallback();
  35. // Only perform take click actions if we were in the pressed state
  36. if (!focusTaken) {
  37. // Use a Runnable and post this rather than calling
  38. // performClick directly. This lets other visual state
  39. // of the view update before click actions start.
  40. if (mPerformClick == null) {
  41. mPerformClick = new PerformClick();
  42. }
  43. if (!post(mPerformClick)) {
  44. //关注点1
  45. //请往下看performClick()的源码分析
  46. performClick();
  47. }
  48. }
  49. }
  50. if (mUnsetPressedState == null) {
  51. mUnsetPressedState = new UnsetPressedState();
  52. }
  53. if (prepressed) {
  54. mPrivateFlags |= PRESSED;
  55. refreshDrawableState();
  56. postDelayed(mUnsetPressedState,
  57. ViewConfiguration.getPressedStateDuration());
  58. } else if (!post(mUnsetPressedState)) {
  59. // If the post failed, unpress right now
  60. mUnsetPressedState.run();
  61. }
  62. removeTapCallback();
  63. }
  64. break;
  65. case MotionEvent.ACTION_DOWN:
  66. if (mPendingCheckForTap == null) {
  67. mPendingCheckForTap = new CheckForTap();
  68. }
  69. mPrivateFlags |= PREPRESSED;
  70. mHasPerformedLongPress = false;
  71. postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
  72. break;
  73. case MotionEvent.ACTION_CANCEL:
  74. mPrivateFlags &= ~PRESSED;
  75. refreshDrawableState();
  76. removeTapCallback();
  77. break;
  78. case MotionEvent.ACTION_MOVE:
  79. final int x = (int) event.getX();
  80. final int y = (int) event.getY();
  81. // Be lenient about moving outside of buttons
  82. int slop = mTouchSlop;
  83. if ((x < 0 - slop) || (x >= getWidth() + slop) ||
  84. (y < 0 - slop) || (y >= getHeight() + slop)) {
  85. // Outside button
  86. removeTapCallback();
  87. if ((mPrivateFlags & PRESSED) != 0) {
  88. // Remove any future long press/tap checks
  89. removeLongPressCallback();
  90. // Need to switch from pressed to not pressed
  91. mPrivateFlags &= ~PRESSED;
  92. refreshDrawableState();
  93. }
  94. }
  95. break;
  96. }
  97. //如果该控件是可以点击的,就一定会返回true
  98. return true;
  99. }
  100. //如果该控件是可以点击的,就一定会返回false
  101. return false;
  102. }

关注点1:
performClick()的源码分析

  1. public boolean performClick() {
  2. sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
  3.  
  4. if (mOnClickListener != null) {
  5. playSoundEffect(SoundEffectConstants.CLICK);
  6. mOnClickListener.onClick( this);
  7. return true;
  8. }
  9. return false;
  10. }
  • 只要mOnClickListener不为null,就会去调用onClick方法;
  • 那么,mOnClickListener又是在哪里赋值的呢?请继续看:
  1. public void setOnClickListener(OnClickListener l) {
  2. if (!isClickable()) {
  3. setClickable( true);
  4. }
  5. mOnClickListener = l;
  6. }
  • 当我们通过调用setOnClickListener方法来给控件注册一个点击事件时,就会给mOnClickListener赋值(不为空),即会回调onClick()。

结论

  1. onTouch()的执行高于onClick()
  2. 每当控件被点击时:
    • 如果在回调onTouch()里返回false,就会让dispatchTouchEvent方法返回false,那么就会执行onTouchEvent();如果回调了setOnClickListener()来给控件注册点击事件的话,最后会在performClick()方法里回调onClick()。

      onTouch()返回false(该事件没被onTouch()消费掉) = dispatchTouchEvent()返回false(继续向下传递) = 执行onTouchEvent() = 执行OnClick()

    • 如果在回调onTouch()里返回true,就会让dispatchTouchEvent方法返回true,那么将不会执行onTouchEvent(),即onClick()也不会执行;

      onTouch()返回true(该事件被onTouch()消费掉) = dispatchTouchEvent()返回true(不会再继续向下传递) = 不会执行onTouchEvent() = 不会执行OnClick()

下面我将用Demo验证上述的结论

Demo论证

1. Demo1:在回调onTouch()里返回true


Demo流程
  1. //设置OnTouchListener()
  2. button.setOnTouchListener( new View.OnTouchListener() {
  3.  
  4. @ Override
  5. public boolean onTouch(View v, MotionEvent event) {
  6. System. out.println("执行了onTouch(), 动作是:" + event.getAction());
  7.  
  8. return true;
  9. }
  10. });
  11.  
  12. //设置OnClickListener
  13. button.setOnClickListener( new View.OnClickListener() {
  14. @ Override
  15. public void onClick(View v) {
  16. System. out.println("执行了onClick()");
  17. }
  18. });

点击Button,测试结果如下:


测试结果

2. Demo2:在回调onTouch()里返回false


Demo流程
  1. //设置OnTouchListener()
  2. button.setOnTouchListener( new View.OnTouchListener() {
  3.  
  4. @ Override
  5. public boolean onTouch(View v, MotionEvent event) {
  6. System. out.println("执行了onTouch(), 动作是:" + event.getAction());
  7.  
  8. return false;
  9. }
  10. });
  11.  
  12. //设置OnClickListener
  13. button.setOnClickListener( new View.OnClickListener() {
  14. @ Override
  15. public void onClick(View v) {
  16. System. out.println("执行了onClick()");
  17. }
  18. });

点击Button,测试结果如下:


测试结果

总结:onTouch()返回true就认为该事件被onTouch()消费掉,因而不会再继续向下传递,即不会执行OnClick()。

如果你看到此处,那么恭喜你,你已经能非常熟悉掌握Android的事件分发机制了(Activity、ViewGroup、View的事件分发机制)


5. 思考点

5.1 onTouch()和onTouchEvent()的区别

  • 这两个方法都是在View的dispatchTouchEvent中调用,但onTouch优先于onTouchEvent执行。
  • 如果在onTouch方法中返回true将事件消费掉,onTouchEvent()将不会再执行。

  • 特别注意:请看下面代码

    1. //&&为短路与,即如果前面条件为false,将不再往下执行
    2. //所以,onTouch能够得到执行需要两个前提条件:
    3. //1. mOnTouchListener的值不能为空
    4. //2. 当前点击的控件必须是enable的。
    5. mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED &&
    6. mOnTouchListener.onTouch( this, event)
  • 因此如果你有一个控件是非enable的,那么给它注册onTouch事件将永远得不到执行。对于这一类控件,如果我们想要监听它的touch事件,就必须通过在该控件中重写onTouchEvent方法来实现。

5.2 Touch事件的后续事件(MOVE、UP)层级传递

  • 如果给控件注册了Touch事件,每次点击都会触发一系列action事件(ACTION_DOWN,ACTION_MOVE,ACTION_UP等)
  • 当dispatchTouchEvent在进行事件分发的时候,只有前一个事件(如ACTION_DOWN)返回true,才会收到后一个事件(ACTION_MOVE和ACTION_UP)

    即如果在执行ACTION_DOWN时返回false,后面一系列的ACTION_MOVE和ACTION_UP事件都不会执行

从上面对事件分发机制分析知:

  • dispatchTouchEvent()和 onTouchEvent()消费事件、终结事件传递(返回true)
  • 而onInterceptTouchEvent 并不能消费事件,它相当于是一个分叉口起到分流导流的作用,对后续的ACTION_MOVE和ACTION_UP事件接收起到非常大的作用

    请记住:接收了ACTION_DOWN事件的函数不一定能收到后续事件(ACTION_MOVE、ACTION_UP)

这里给出ACTION_MOVE和ACTION_UP事件的传递结论

  • 如果在某个对象(Activity、ViewGroup、View)的dispatchTouchEvent()消费事件(返回true),那么收到ACTION_DOWN的函数也能收到ACTION_MOVE和ACTION_UP

    黑线:ACTION_DOWN事件传递方向
    红线:ACTION_MOVE和ACTION_UP事件传递方向


流程讲解
  • 如果在某个对象(Activity、ViewGroup、View)的onTouchEvent()消费事件(返回true),那么ACTION_MOVE和ACTION_UP的事件从上往下传到这个View后就不再往下传递了,而直接传给自己的onTouchEvent()并结束本次事件传递过程。

    黑线:ACTION_DOWN事件传递方向
    红线:ACTION_MOVE和ACTION_UP事件传递方向


流程讲解

6. 总结

    • 通过阅读本文,相信你已经全面了解Android事件分发机制;


免责声明!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系本站邮箱yoyou2525@163.com删除。



 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM