Android 事件分发机制详解（上）

前言

Android事件分发机制是Android开发者必须了解的基础。

一. 基础认知

1.1 事件分发的由来

安卓的View是树形结构的，View可能会重叠在一起，当我们点击的地方有多个View都可以响应的时候，这个点击事件应该给谁呢？为了解决这一个问题，就有了事件分发机制。

1.2 事件分发的 “事件” 是指什么？

点击事件 (Touch事件) 。具体介绍如下：

特别说明：事件列，即指从手指接触屏幕至手指离开屏幕这个过程产生的一系列事件。一般情况下，事件列都是以DOWN事件开始、UP事件结束，中间有无数的MOVE事件。

1.3 事件分发的本质

将点击事件（MotionEvent）传递到某个具体的View & 处理的整个过程。

即事件传递的过程 = 分发过程。

1.4 事件在哪些对象之间进行传递？

答：Activity、ViewGroup、View。

类型	简介	备注
Activity	控制生命周期&处理事件(类似控制器)	统筹视图的添加 & 显示通过其他回调方法与Window、View交互
View	所有UI组件的基类	一般Button、TextView等控件都是继承父类View
ViewGroup	一组View的集合(含多个子View)	其本身也是View的子类是Android所有布局的父类：如LinearLayout等区别于普通View: ViewGroup实际上也是1个View,只是多了可包含子View & 定义布局参数的功能

1.5 事件分发的顺序

即事件传递的顺序：Activity -> ViewGroup -> View

即：1个点击事件发生后，事件先传到Activity、再传到ViewGroup、最终再传到View

1.6 事件分发过程由哪些方法协作完成？

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

方法	作用	调用时刻
dispatchTouchEvent()	分发（传递）点击事件	当点击事件能够传递给当前View时，该方法就会被调用
onTouchEvent()	处理点击事件	在dispatchTouchEvent() 内部调用
onInterceptTouchEvent()	判断是否拦截了某个事件只存在于ViewGroup 普通的View无该方法	在ViewGroup的dispatchTouchEvent(）内部调用

二. 事件分发机制流程详细分析

主要包括：Activity事件分发机制、ViewGroup事件分发机制、View事件分发机制

2.1 Activity事件分发机制

事件分发机制，首先会将点击事件传递到Activity中，具体是执行 dispatchTouchEvent() 进行事件分发。
源码分析

/**
  * 源码分析：Activity.dispatchTouchEvent（）
  */ 
  public boolean dispatchTouchEvent(MotionEvent ev) {
   
    // 仅贴出核心代码
    // ->>分析1
    if (getWindow().superDispatchTouchEvent(ev)) {
   
        return true;
        // 若getWindow().superDispatchTouchEvent(ev)的返回true
        // 则Activity.dispatchTouchEvent（）就返回true，则方法结束。即 ：该点击事件停止往下传递 & 事件传递过程结束
        // 否则：继续往下调用Activity.onTouchEvent
    }
    // ->>分析3
    return onTouchEvent(ev);
  }
/**
  * 分析1：getWindow().superDispatchTouchEvent(ev)
  * 说明：
  *     a. getWindow() = 获取Window类的对象
  *     b. Window类是抽象类，其唯一实现类 = PhoneWindow类
  *     c. Window类的superDispatchTouchEvent() = 1个抽象方法，由子类PhoneWindow类实现
  */
  @Override
  public boolean superDispatchTouchEvent(MotionEvent event) {
   
      return mDecor.superDispatchTouchEvent(event);
      // mDecor = 顶层View（DecorView）的实例对象
      // ->> 分析2
  }
/**
  * 分析2：mDecor.superDispatchTouchEvent(event)
  * 定义：属于顶层View（DecorView）
  * 说明：
  *     a. DecorView类是PhoneWindow类的一个内部类
  *     b. DecorView继承自FrameLayout，是所有界面的父类
  *     c. FrameLayout是ViewGroup的子类，故DecorView的间接父类 = ViewGroup
  */
  public boolean superDispatchTouchEvent(MotionEvent event) {
   
      return super.dispatchTouchEvent(event);
      // 调用父类的方法 = ViewGroup的dispatchTouchEvent()
      // 即将事件传递到ViewGroup去处理，详细请看后续章节分析的ViewGroup的事件分发机制
  }
  // 回到最初的分析2入口处
/**
  * 分析3：Activity.onTouchEvent()
  * 调用场景：当一个点击事件未被Activity下任何一个View接收/处理时，就会调用该方法
  */
  public boolean onTouchEvent(MotionEvent event) {
   
        // ->> 分析5
        if (mWindow.shouldCloseOnTouch(this, event)) {
   
            finish();
            return true;
        }
        return false;
        // 即 只有在点击事件在Window边界外才会返回true，一般情况都返回false，分析完毕
    }
/**
  * 分析4：mWindow.shouldCloseOnTouch(this, event)
  * 作用：主要是对于处理边界外点击事件的判断：是否是DOWN事件，event的坐标是否在边界内等
  */
  public boolean shouldCloseOnTouch(Context context, MotionEvent event) {
   
  if (mCloseOnTouchOutside && event.getAction() == MotionEvent.ACTION_DOWN
          && isOutOfBounds(context, event) && peekDecorView() != null) {
   
        // 返回true：说明事件在边界外，即 消费事件
        return true;
    }
    // 返回false：在边界内，即未消费（默认）
    return false;
  }

源码总结

当一个点击事件发生时，从Activity的事件分发开始（ Activity.dispatchTouchEvent() ），流程总结如下：

核心方法总结

主要包括：dispatchTouchEvent()、onTouchEvent() 总结如下：

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

2.2 ViewGroup事件分发机制

从上面Activity的事件分发机制可知，在 Activity.dispatchTouchEvent() 实现了将事件从Activity -> ViewGroup 的传递，ViewGroup的事件分发机制从 dispatchTouchEvent() 开始。

源码分析

/**
  * 源码分析：ViewGroup.dispatchTouchEvent（）
  */ 
  public boolean dispatchTouchEvent(MotionEvent ev) {
    
  // 仅贴出关键代码
  ... 
  if (disallowIntercept || !onInterceptTouchEvent(ev)) {
     
  // 分析1：ViewGroup每次事件分发时，都需调用onInterceptTouchEvent()询问是否拦截事件
    // 判断值1-disallowIntercept：是否禁用事件拦截的功能(默认是false)，可通过调用requestDisallowInterceptTouchEvent()修改
    // 判断值2-!onInterceptTouchEvent(ev) ：对onInterceptTouchEvent()返回值取反
        // a. 若在onInterceptTouchEvent()中返回false，即不拦截事件，从而进入到条件判断的内部
        // b. 若在onInterceptTouchEvent()中返回true，即拦截事件，从而跳出了该条件判断
        // c. 关于onInterceptTouchEvent() ->>分析1
  // 分析2
    // 1. 通过for循环，遍历当前ViewGroup下的所有子View
    for (int i = count - 1; i >= 0; i--) {
     
        final View child = children[i];  
        if ((child.mViewFlags & VISIBILITY_MASK) == VISIBLE  
                || child.getAnimation() != null) {
     
            child.getHitRect(frame);  
            // 2. 判断当前遍历的View是不是正在点击的View，从而找到当前被点击的View
            if (frame.contains(scrolledXInt, scrolledYInt)) {
     
                final float xc = scrolledXFloat - child.mLeft;  
                final float yc = scrolledYFloat - child.mTop;  
                ev.setLocation(xc, yc);  
                child.mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;  
                // 3. 条件判断的内部调用了该View的dispatchTouchEvent()
                // 即 实现了点击事件从ViewGroup到子View的传递（具体请看下面章节介绍的View事件分发机制）
                if (child.dispatchTouchEvent(ev))  {
    
                // 调用子View的dispatchTouchEvent后是有返回值的
                // 若该控件可点击，那么点击时dispatchTouchEvent的返回值必定是true，因此会导致条件判断成立
                // 于是给ViewGroup的dispatchTouchEvent()直接返回了true，即直接跳出
                // 即该子View把ViewGroup的点击事件消费掉了
                mMotionTarget = child;  
                return true; 
                      }  
                  }  
              }  
          }  
      }  
    }  
  ...
  return super.dispatchTouchEvent(ev);
  // 若无任何View接收事件(如点击空白处)/ViewGroup本身拦截了事件(复写了onInterceptTouchEvent()返回true)
  // 会调用ViewGroup父类的dispatchTouchEvent()，即View.dispatchTouchEvent()
  // 因此会执行ViewGroup的onTouch() -> onTouchEvent() -> performClick（） -> onClick()，即自己处理该事件，事件不会往下传递
  // 具体请参考View事件分发机制中的View.dispatchTouchEvent()
  ... 
}
/**
  * 分析1：ViewGroup.onInterceptTouchEvent()
  * 作用：是否拦截事件
  * 说明：
  *     a. 返回false：不拦截（默认）
  *     b. 返回true：拦截，即事件停止往下传递（需手动复写onInterceptTouchEvent()其返回true）
  */
  public boolean onInterceptTouchEvent(MotionEvent ev) {
     
    // 默认不拦截
    return false;
  } 
  // 回到调用原处

源码总结

Android事件分发传递到Acitivity后，总是先传递到 ViewGroup 、再传递到 View 。流程总结如下：(假设已经经过了Acitivity事件分发传递并传递到 ViewGroup )

核心方法总结

主要包括： dispatchTouchEvent() 、 onTouchEvent() 、 onInterceptTouchEvent() 总结如下：

实例分析

1. 布局说明

2. 测试代码

布局文件：activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/my_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:focusableInTouchMode="true"
    android:orientation="vertical">
    <Button
        android:id="@+id/button1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="按钮1" />
    <Button
        android:id="@+id/button2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="按钮2" />
</LinearLayout>

核心代码：MainActivity.java

public class MainActivity extends AppCompatActivity {
   
  Button button1,button2;
  ViewGroup myLayout;
  @Override
  public void onCreate(Bundle savedInstanceState) {
   
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      button1 = (Button)findViewById(R.id.button1);
      button2 = (Button)findViewById(R.id.button2);
      myLayout = (LinearLayout)findViewById(R.id.my_layout);
      // 1.为ViewGroup布局设置监听事件
      myLayout.setOnClickListener(new View.OnClickListener() {
   
          @Override
          public void onClick(View v) {
   
              Log.d("TAG", "点击了ViewGroup");
          }
      });
      // 2. 为按钮1设置监听事件
      button1.setOnClickListener(new View.OnClickListener() {
   
          @Override
          public void onClick(View v) {
   
              Log.d("TAG", "点击了button1");
          }
      });
      // 3. 为按钮2设置监听事件
      button2.setOnClickListener(new View.OnClickListener() {
   
          @Override
          public void onClick(View v) {
   
              Log.d("TAG", "点击了button2");
          }
      });
   }
}

3. 测试结果

// 点击按钮1，输出如下
点击了button1
// 点击按钮2，输出如下
点击了button2
// 点击空白处，输出如下
点击了ViewGroup

4. 结果分析

点击Button时，因为ViewGroup默认不拦截，所以事件会传递到子View Button，于是执行Button.onClick()。
此时ViewGroup. dispatchTouchEvent()会直接返回true，所以ViewGroup自身不会处理该事件，于是ViewGroupLayout的dispatchTouchEvent()不会执行，所以注册的onTouch()不会执行，即onTouchEvent()-> performClick()-> onClick()整个链路都不会执行，所以最后不会执行ViewGroup设置的onClick()里。
点击空白区域时，ViewGroup. dispatchTouchEvent()里遍历所有子View希望找到被点击子View时找不到，所以ViewGroup自身会处理该事件，于是执行onTouchEvent() -> performClick() -> onClick()，最终执行ViewGroupLayout的设置的onClick()。