Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 七 )
Posted 韩曙亮
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 七 )相关的知识，希望对你有一定的参考价值。
android 事件分发 系列文章目录
【Android 事件分发】事件分发源码分析 ( 驱动层通过中断传递事件 | WindowManagerService 向 View 层传递事件 )
【Android 事件分发】事件分发源码分析 ( Activity 中各层级的事件传递 | Activity -＞ PhoneWindow -＞ DecorView -＞ ViewGroup )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 一 )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 二 )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 三 )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 四 | View 事件传递机制 )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 五 )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 六 )
【Android 事件分发】事件分发源码分析 ( ViewGroup 事件传递机制 七 )
文章目录
总结
事件分发 主要是解决 事件冲突 问题 ,
父容器事件冲突问题主要解决方案是使用 ViewGroup 拦截事件 , 屏蔽后续的子组件事件分发 ;
子组件事件冲突 , 可以自己设置 OnTouchListener , 精准控制 按下 , 移动 , 抬起 , 取消 等触摸事件 , 自己设计具体的业务逻辑 ;
一、ViewGroup | dispatchTouchEvent 完整流程分析
第一步 : 判断是否是按下操作 ;
// 第一步 : 判断是否是按下操作
// Handle an initial down.
// 判断是否是第一次按下 , 如果是第一次按下 , 则执行下面的业务逻辑
if (actionMasked == MotionEvent.ACTION_DOWN) {
// Throw away all previous state when starting a new touch gesture.
// The framework may have dropped the up or cancel event for the previous gesture
// due to an app switch, ANR, or some other state change.
cancelAndClearTouchTargets(ev);
// 如果是第一次按下 , 那么重置触摸状态
resetTouchState();
}
第二步 : 判断是否需要拦截 , 用户使用 requestDisallowInterceptTouchEvent 方法进行设置是否拦截事件 ;
// 第二步 : 判断是否需要拦截 , 用户使用 requestDisallowInterceptTouchEvent 方法进行设置是否拦截事件
// Check for interception.
// 判定是否拦截
// 用于多点触控按下操作的判定
final boolean intercepted;
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {
// 判断是否需要拦截 , 可以使用 requestDisallowInterceptTouchEvent 方法进行设置
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
if (!disallowIntercept) {
// 进行事件拦截
// 该 onInterceptTouchEvent 方法只返回是否进行事件拦截 , 返回一个布尔值 , 没有进行具体的事件拦截
// 是否进行拦截 , 赋值给了 intercepted 局部变量
// 该值决定是否进行拦截
intercepted = onInterceptTouchEvent(ev);
ev.setAction(action); // restore action in case it was changed
} else {
// 不进行事件拦截
intercepted = false;
}
} else {
// There are no touch targets and this action is not an initial down
// so this view group continues to intercept touches.
intercepted = true;
}
// If intercepted, start normal event dispatch. Also if there is already
// a view that is handling the gesture, do normal event dispatch.
if (intercepted || mFirstTouchTarget != null) {
ev.setTargetAccessibilityFocus(false);
}
第三步 : 判定该动作是否是取消动作 , 手指移出组件边界范围就是取消事件 ;
// 第三步 : 判定该动作是否是取消动作 , 手指移出组件边界范围就是取消事件 ;
// Check for cancelation.
// 检查是否取消操作 , 手指是否移除了组件便捷 ;
// 一般情况默认该值是 false ;
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;
第四步 : 判定是否拦截事件 , 以及是否取消事件 , 如果都为否 ;
// 第四步 : 判定是否拦截事件 , 以及是否取消事件 , 如果都为否
// 即不拦截事件 , 该事件也不取消 , 则执行该分支
// 在该分支中 , 记录该触摸事件
// 此处判定 , 是否拦截
// 假定不取消 , 也不拦截
// canceled 和 intercepted 二者都是 false , 才不能拦截 ;
if (!canceled && !intercepted) {
第五步 : 判定是否是按下操作 , 如果是 , 则记录该事件 , 如果不是 , 则不执行该分支 ;
// 第五步 : 判定是否是按下操作 , 如果是 , 则记录该事件 , 如果不是 , 则不执行该分支
// 判断是否是按下操作
// 一个完整的动作 , 只有第一次按下 , 才执行下面的逻辑
// 第一次按下后 , 手指按着移动 , 属于第2次以及之后的第n次动作 , 不再走该分支
// 直接执行该分支后面的代码
if (actionMasked == MotionEvent.ACTION_DOWN
|| (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
第六步 : 对子控件进行排序 ;
// 第六步 : 对子控件进行排序
// Find a child that can receive the event.
// Scan children from front to back.
// 子组件排序 , 按照 Z 轴排列的层级 , 从上到下进行排序 ,
// 控件会相互重叠 , Z 轴的排列次序上 ,
// 顶层的组件优先获取到触摸事件
final ArrayList<View> preorderedList = buildTouchDispatchChildList();
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
第七步 : 倒序遍历 , 取顶层组件 ;
// 第七步 : 倒序遍历 , 取顶层组件
// 倒序遍历 按照 Z 轴的上下顺序 , 排列好的组件
// 先遍历的 Z 轴方向上 , 放在最上面的组件 , 也就是顶层组件
for (int i = childrenCount - 1; i >= 0; i--) {
// 获取索引
final int childIndex = getAndVerifyPreorderedIndex(
childrenCount, i, customOrder);
// 获取索引对应组件
final View child = getAndVerifyPreorderedView(
preorderedList, children, childIndex);
第八步 : 判定当前事件是否可用 , 组件可见 , 不处于动画阶段 , 手指在组件范围中 ;
// 第八步 : 判定当前事件是否可用 , 组件可见 , 不处于动画阶段 , 手指在组件范围中
// X 控件范围 A , 如果手指按在 B 范围 , 不会触发 X 控件的事件
// 判定当前的组件是否可见 , 是否处于动画过程中
// ① canViewReceivePointerEvents 判定组件是否可见 , 会否处于动画
// ② isTransformedTouchPointInView 判定手指是否在控件上面 ;
// 上述两种情况 , 不触发事件
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
ev.setTargetAccessibilityFocus(false);
// 不触发事件
continue;
}
第九步 : 正式向子组件分发触摸事件 ;
- 如果分发事件被消耗掉 , 返回 true , 则记录该事件 ; 记录事件调用的 addTouchTarget 方法中 , 为 mFirstTouchTarget 成员变量赋值 ;
- 如果分发事件没有被消耗掉 , 返回 false ;
// 第九步 : 正式向子组件分发触摸事件
// 如果分发事件被消耗掉 , 返回 true , 则记录该事件
// 记录事件调用的 addTouchTarget 方法中 , 为 mFirstTouchTarget 成员变量赋值
// 如果分发事件没有被消耗掉 , 返回 false
// 正式开始分发触摸事件
// 处理以下两种情况 :
// ① 情况一 : 子控件触摸事件返回 true
// ② 情况二 : 子控件触摸事件返回 false
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
第十步 : 判定当前是否有消费记录 , 即 Down 按下事件是否执行完毕 ;
- 如果有事件消费记录则 mFirstTouchTarget 成员不为空 , 此时从 TouchTarget 链表中取出相应的消费 Down 事件组件 , 直接将事件分发给该组件 ;
- 如果没有事件消费记录 , 则 mFirstTouchTarget 成员为空 , 此时调用 dispatchTransformedTouchEvent 方法消费自己 ;
// 第十步 : 判定当前是否有消费记录 , 即 Down 按下事件是否执行完毕
// 如果有事件消费记录则 mFirstTouchTarget 成员不为空 , 此时从 TouchTarget 链表中取出相应的消费 Down 事件组件 , 直接将事件分发给该组件
// 如果没有事件消费记录 , 则 mFirstTouchTarget 成员为空 , 此时调用 dispatchTransformedTouchEvent 方法消费自己 ;
// 上面的分支是只有第一次按下时才执行的
// 假如当前动作时按下以后的移动/抬起动作
// 则跳过上面的分支 , 直接执行后面的代码逻辑
// 按下之后 mFirstTouchTarget 肯定不为空
// 如果事件被消费 , 事件分发方法 dispatchTransformedTouchEvent 返回 true
// 就会创建 newTouchTarget 值 , 该值不会为空 , 同时 mFirstTouchTarget 不为空
// 反之
// 如果上述事件分发方法 dispatchTransformedTouchEvent 返回 false
// 此时 newTouchTarget 值 , 就会为空 , 同时 mFirstTouchTarget 为空
//
// 还有一个逻辑就是 , 如果该事件被父容器拦截 , mFirstTouchTarget 也是 null 值
// 调用 dispatchTransformedTouchEvent , 但是传入的子组件时 null
// 在 dispatchTransformedTouchEvent 方法中触发调用 if (child == null) 分支的
// handled = super.dispatchTouchEvent(event) 方法 , 调用父类的事件分发方法
// Dispatch to touch targets.
if (mFirstTouchTarget == null) {
// 事件没有被消费的分支
// No touch targets so treat this as an ordinary view.
handled = dispatchTransformedTouchEvent(ev, canceled, null,
TouchTarget.ALL_POINTER_IDS);
} else {
// TouchTarget 对象对应着一个完整的动作 , 该动作包含 1 个按下事件 , 若干 移动 事件 , 1 个抬起事件 ;
// 第一次按下 , 负责构建 TouchTarget 链表 , 将消费事件的 View 组件封装到 TouchTarget 中
// 然后的移动/抬起操作 , 不再重复的创建 TouchTarget 对象了
// 直接使用第一次按下的 TouchTarget 对象作为当前动作的标识
// 直接向该 TouchTarget 对象中的 View 组件分发事件
// 这也是我们按下按钮时 , 即使将手指按着移出边界 , 按钮也处于按下状态 ;
// 事件被消费的分支 , 事件消费成功 , 会走这个分支
// Dispatch to touch targets, excluding the new touch target if we already
// dispatched to it. Cancel touch targets if necessary.
TouchTarget predecessor = null;
// 将当前所有的消费的事件以及消费的 View 组件做成了一个链表
TouchTarget target = mFirstTouchTarget;
while (target != null) {
// 链表式操作 , 检索是哪个组件 , 然后开始分发
final TouchTarget next = target.next;
if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
handled = true;
} else {
final boolean cancelChild = resetCancelNextUpFlag(target.child)
|| intercepted;
// 找到了 View , 开始分发触摸事件
if (dispatchTransformedTouchEvent(ev, cancelChild,
target.child, target.pointerIdBits)) {
handled = true;
}
if (cancelChild) {
if (predecessor == null) {
mFirstTouchTarget = next;
} else {
predecessor.next = next;
}
target.recycle();
target = next;
continue;
}
}
predecessor = target;
target = next;
}
}
二、ViewGroup | dispatchTransformedTouchEvent 完整流程分析
如果事件被拦截 , 或者没有被消费掉 , 则不会对 mFirstTouchTarget 进行初始化 , mFirstTouchTarget 为空 ;
ViewGroup | dispatchTransformedTouchEvent 方法中 ,
- 传入的子组件为空 , 表示事件被拦截了 , 或消费不成功 , 此时需要消费自己的触摸事件 , 调用父类 View 的 dispatchTouchEvent 方法就是消费自己的触摸事件 ;
- 传入的子组件不为空 , 则将事件传递给子组件 ;
/**
* Transforms a motion event into the coordinate space of a particular child view,
* filters out irrelevant pointer ids, and overrides its action if necessary.
* If child is null, assumes the MotionEvent will be sent to this ViewGroup instead.
* 该方法是正式分发触摸事件的方法
* 注意参数中传入了当前正在被遍历的 child 子组件
* 如果事件被拦截 , 或者没有被消费掉 , 则不会对 mFirstTouchTarget 进行初始化 , mFirstTouchTarget 为空
*/
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
View child, int desiredPointerIdBits) {
final boolean handled;
// Canceling motions is a special case. We don't need to perform any transformations
// or filtering. The important part is the action, not the contents.
// 处理取消状态 , 暂时不分析 ;
final int oldAction = event.getAction();
if (cancel || oldAction == MotionEvent.ACTION_CANCEL) {
event.setAction(MotionEvent.ACTION_CANCEL);
if (child == null) {
// 传入的子组件为空
// 表示事件被拦截了 / 或消费不成功
// 消费自己的触摸事件 , 调用父类 View 的 dispatchTouchEvent 方法就是消费自己的触摸事件
handled = super.dispatchTouchEvent(event);
} else {
// 组件不为空 , 则将事件传递给子组件
handled = child.dispatchTouchEvent(event);
}
event.setAction(oldAction);
return handled;
}
}
三、View | dispatchTouchEvent 完整流程分析
View | dispatchTouchEvent 方法中 , 会调用 View 的 OnTouchListener 方法 , OnTouchListener 是在 View 的 ListenerInfo mListenerInfo 成员中的 OnTouchListener mOnTouchListener 成员 ;
这是用户设置的 触摸监听器 , 是开发时设置的组件的触摸事件 , 返回 true / false ;
如果返回 true 则成功消费事件 , 事件分发到此结束 ;
如果返回 false , 则事件继续向下传递 ;
public class View implements Drawable.Callback, KeyEvent.Callback,
AccessibilityEventSource {
public boolean dispatchTouchEvent(MotionEvent event) {
if ((mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)) {
result = true;
}
//noinspection SimplifiableIfStatement
// 设置的 触摸监听器 就是封装在该对象中
ListenerInfo li = mListenerInfo;
// 判断该组件是否被用户设置了 触摸监听器 OnTouchListener
if (li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
// 执行被用户设置的 触摸监听器 OnTouchListener
&& li.mOnTouchListener.onTouch(this, event)) {
// 如果用户设置的 触摸监听器 OnTouchListener 触摸方法返回 true
// 此时该分发方法的返回值就是 true
result = true;
}
}
}
源码路径 : /frameworks/base/core/java/android/view/View.java
四、ViewGroup 事件分发相关源码
@UiThread
public abstract class ViewGroup extends View implements ViewParent, ViewManager {
// First touch target in the linked list of touch targets.
private TouchTarget mFirstTouchTarget;
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
// 辅助功能 , 残疾人相关辅助 , 跨进程调用 无障碍 功能
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(ev, 1);
}
// If the event targets the accessibility focused view and this is it, start
// normal event dispatch. Maybe a descendant is what will handle the click.
// 判断产生事件的目标组件是可访问性的 , 那么按照普通的事件分发进行处理 ;
// 可能由其子类处理点击事件 ;
// 判断当前是否正在使用 无障碍 相关功能产生事件
if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) {
ev.setTargetAccessibilityFocus(false);
}
// 是否按下操作 , 最终的对外返回结果 , 该方法的最终返回值
boolean handled = false;
if (onFilterTouchEventForSecurity(ev)) {
final int action = ev.getAction();
final int actionMasked = action & MotionEvent.ACTION_MASK;
// 第一步 : 判断是否是按下操作
// Handle an initial down.
// 判断是否是第一次按下 , 如果是第一次按下 , 则执行下面的业务逻辑
if (actionMasked == MotionEvent.ACTION_DOWN) {
// Throw away all previous state when starting a new touch gesture.
// The framework may have dropped the up or cancel event for the previous gesture
// due to an app switch, ANR, or some other state change.
cancelAndClearTouchTargets(ev);
// 如果是第一次按下 , 那么重置触摸状态
resetTouchState();
}
// 第二步 : 判断是否需要拦截 , 用户使用 requestDisallowInterceptTouchEvent 方法进行设置是否拦截事件
// Check for interception.
// 判定是否拦截
// 用于多点触控按下操作的判定
final boolean intercepted;
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {
// 判断是否需要拦截 , 可以使用 requestDisallowInterceptTouchEvent 方法进行设置
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
if (!disallowIntercept) {
// 进行事件拦截
// 该 onInterceptTouchEvent 方法只返回是否进行事件拦截 , 返回一个布尔值 , 没有进行具体的事件拦截
// 是否进行拦截 , 赋值给了 intercepted 局部变量
// 该值决定是否进行拦截
intercepted = onInterceptTouchEvent(ev);
ev.setAction(action); // restore action in case it was changed
} else {
// 不进行事件拦截
intercepted = false;
}
} else {
// There are no touch targets and this action is not an initial down
// so this view group continues to intercept touches.
intercepted = true;
}
// If intercepted, start normal event dispatch. Also if there is already
// a view that is handling the gesture, do normal event dispatch.
if (intercepted || mFirstTouchTarget != null) {
ev.setTargetAccessibilityFocus(false);
}
// 第三步 : 判定该动作是否是取消动作 , 手指移出组件边界范围就是取消事件 ;
// Check for cancelation.
// 检查是否取消操作 , 手指是否移除了组件便捷 ;
// 一般情况默认该值是 false ;
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;
// Update list of touch targets for pointer down, if needed.
final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
// 注意此处 newTouchTarget 为空
TouchTarget newTouchTarget = null;
boolean alreadyDispatchedToNewTouchTarget = false;
// 第四步 : 判定是否拦截事件 , 以及是否取消事件 , 如果都为否
// 即不拦截事件 , 该事件也不取消 , 则执行该分支
// 在该分支中 , 记录该触摸事件
// 此处判定 , 是否拦截
// 假定不取消 , 也不拦截
// canceled 和 intercepted 二者都是 false , 才不能拦截 ;
if (!canceled && !intercepted) {
// If the event is targeting accessibility focus we give it to the
// view that has accessibility focus and if it does not handle it
// we clear the flag and dispatch the event to all children as usual.
// We are looking up the accessibility focused host to avoid keeping
// state since these events are very rare.
// 无障碍 辅助功能
View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus()
? findChildWithAccessibilityFocus() : null;
// 第五步 : 判定是否是按下操作 , 如果是 , 则记录该事件 , 如果不是 , 则不执行该分支
// 判断是否是按下操作
// 一个完整的动作 , 只有第一次按下 , 才执行下面的逻辑
// 第一次按下后 , 手指按着移动 , 属于第2次以及之后的第n次动作 , 不再走该分支
// 直接执行该分支后面的代码
if (actionMasked == MotionEvent.ACTION_DOWN
|| (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
// 获取触摸索引值
final int actionIndex = ev.getActionIndex(); // always 0 for down
final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
: TouchTarget.ALL_POINTER_IDS;
// Clean up earlier touch targets for this pointer id in case they
// have become out of sync.
removePointersFromTouchTargets(idBitsToAssign);
// 计算 ViewGroup 父容器下面有多少个子 View 组件 ;
final int childrenCount = mChildrenCount;
// TouchTarget newTouchTarget = null; 在上面声明为空 , 此处肯定为 null ;
// childrenCount 子组件个数不为 0
// 如果子组件个数为 0 , 则不走下一段代码 , 如果子组件个数大于 0 , 则执行下一段代码 ;
// 说明下面的代码块中处理的是 ViewGroup 中子组件的事件分发功能 ;
if (newTouchTarget == null && childrenCount != 0) {
// 获取单个手指的 x,y 坐标
final float x = ev.getX(actionIndex);
final float y = ev.getY(actionIndex);
// 第六步 : 对子控件进行排序
// Find a child that can receive the event.
// Scan children from front to back.
// 子组件排序 , 按照 Z 轴排列的层级 , 从上到下进行排序 ,
// 控件会相互重叠 , Z 轴的排列次序上 ,
// 顶层的组件优先获取到触摸事件
final ArrayList<View> preorderedList = buildTouchDispatchChildList();
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
// 第七步 : 倒序遍历 , 取顶层组件
// 倒序遍历 按照 Z 轴的上下顺序 , 排列好的组件
// 先遍历的 Z 轴方向上 , 放在最上面的组件 , 也就是顶层组件
for (int i = childrenCount - 1; i >= 0; i--) {
// 获取索引
final int childIndex = getAndVerifyPreorderedIndex(
childrenCount, i, customOrder);
// 获取索引对应组件
final View child = getAndVerifyPreorderedView(
preorderedList, children, childIndex);
// If there is a view that has accessibility focus we want it
// to get the event first and if not handled we will perform a
// normal dispatch. We may do a double iteration but this is
// safer given the timeframe.
// 无障碍 辅助功能
if (ch以上是关于Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 七 )的主要内容，如果未能解决你的问题，请参考以下文章
Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 二 )
Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 一 )
Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 七 )
Android 事件分发事件分发源码分析 ( ViewGroup 事件传递机制 六 )
Android 事件分发ItemTouchHelper 事件分发源码分析 ( 绑定 RecyclerView )
Android 事件分发ItemTouchHelper 源码分析 ( OnItemTouchListener 事件监听器源码分析 )