本文适用于对Android事件分发机制有一定基础的开发者阅读,主要是通过对ViewGroup类中的事件分发、事件拦截的源代码进行解析以达到完全理解其原理的目的
- (一)Android事件分发机制 - View篇
- (二)Android事件分发机制 - ViewGroup篇
- (三)Android事件分发机制 - Activity篇
- (四)Android事件分发机制 - 总结篇
我们知道ViewGroup中包含dispatchTouchEvent
、onInterceptTouchEvent
和onTouchEvent
方法,接下来我们通过源代码(基于Android6.0)看看这些方法内部到底做了哪些事情。
ViewGroup#dispatchTouchEvent源码解析
初始化ACTION_DOWN事件
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
...
if (actionMasked == MotionEvent.ACTION_DOWN) {
// 这里会将mFirstTouchTarget置为 null
cancelAndClearTouchTargets(ev);
resetTouchState();
}
...
}
- 由于一个完整的事件序列是以ACTINON_DOWN开始,以ACTINON_UP结束,所以如果是ACTINON_DOWN事件,那么说明是一个新的事件序列,所以需要初始化之前的状态。
检查ViewGroup是否要拦截事件
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
...
final boolean intercepted;
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
if (!disallowIntercept) {
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;
}
...
// Check for cancelation.
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;
// ...
}
public boolean onInterceptTouchEvent(MotionEvent ev) {
return false;
}
- 定义了一个布尔值intercept来记录是否要进行拦截;
- 如果事件是ACTION_DOWN或者mFirstTouchTatget值不为空才有可能执行到onInterceptTouchEvent方法,否则intercept = true;
那么为什么要有这个判断呢?
如果子View消耗了ACTION_DOWN事件,那么mFirstTouchTarget将指向该子View,而后ViewGroup继续判断是否要拦截接下来的ACTION_MOVE等事件;
如果子View没有消耗ACTION_DOWN事件,那么mFirstTouchTarget将为null,后续事件到来时,会直接把intercept设置为true,并将事件交由ViewGroup处理。 - FLAG_DISALLOW_INTERCEPT这个标志位特别有用,它可以用来禁止或允许ViewGroup拦截除了DOWN之外的事件,一般通过子View调用requestDisallowInterceptTouchEvent来设置;
- ViewGroup#onInterceptTouchEvent()方法是默认返回false的,即ViewGroup默认不拦截任何事件,如果想要让ViewGroup拦截事件,那么应该在自定义的ViewGroup中重写这个方法。
对ACTION_DWON事件的特殊处理
接下来是一个If判断语句,内部还有若干if语句,以下先省略所有if体的内容,我们从大体上认识这块代码的作用:
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
...
TouchTarget newTouchTarget = null;
boolean alreadyDispatchedToNewTouchTarget = false;
if (!canceled && !intercepted) {
...// IF体1
if (actionMasked == MotionEvent.ACTION_DOWN
|| (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
...// IF体2
}
}
...
}
将newTouchTarget置为null,alreadyDispatchedToNewTouchTarget置为false;
如果事件是未被取消(!canceled)并且ViewGroup不拦截事件(!intercepted)则进入IF体1;
-
接下来继续判断如果(actionMasked == MotionEvent.ACTION_DOWN...)则进入IF体2:
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); final int childrenCount = mChildrenCount; if (newTouchTarget == null && childrenCount != 0) { ...// IF体3 } if (newTouchTarget == null && mFirstTouchTarget != null) { ... } }
-
如果ViewGroup内部子View的数量childrenCount != 0进入IF体3:
if (newTouchTarget == null && childrenCount != 0) { ... for (int i = childrenCount - 1; i >= 0; i--) { final int childIndex = customOrder ? getChildDrawingOrder(childrenCount, i) : i; final View child = (preorderedList == null) ? children[childIndex] : preorderedList.get(childIndex); ... if (!canViewReceivePointerEvents(child) || !isTransformedTouchPointInView(x, y, child, null)) { ev.setTargetAccessibilityFocus(false); continue; } ... if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) { ... } ... } if (preorderedList != null) preorderedList.clear(); }
对ViewGroup内部的子View进行倒序遍历,即从最上层的View开始往下层遍历,一个个地找到能接受事件的子View;
如果子View不能接受触碰事件 - View不可见或者有动画效果(!canViewReceivePointerEvents(child))或者触摸点位置不在子View的范围内(!isTransformedTouchPointInView(x, y, child, null)),则continue,表示这个子View不符合条件,开始遍历下一个子View;
-
找到符合条件的子View后调用dispatchTransformedTouchEvent()方法:
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel, View child, int desiredPointerIdBits) { final boolean handled; ... if (child == null) { handled = super.dispatchTouchEvent(event); } else { handled = child.dispatchTouchEvent(event); } event.setAction(oldAction); return handled; ... }
当传递进来的的child != null时,就会调用子View的dispatchTouchEvent(event)方法,表示把事件交给子View处理,完成了ViewGroup到子View的事件传递,当事件处理完毕,就会返回一个布尔值handled,该值表示子View是否消耗了事件。
当传递进来的的child == null时,就会调用ViewGroup的dispatchTouchEvent(event)方法,表示把事件交给父View处理;
-
dispatchTransformedTouchEvent方法返回true时,表示子View消耗了事件:
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) { ... newTouchTarget = addTouchTarget(child, idBitsToAssign); alreadyDispatchedToNewTouchTarget = true; ... break; } private TouchTarget addTouchTarget(View child, int pointerIdBits) { TouchTarget target = TouchTarget.obtain(child, pointerIdBits); target.next = mFirstTouchTarget; mFirstTouchTarget = target; return target; }
此时把mFirstTouchTarget指向child,同时把newTouchTarget也指向child,alreadyDispatchedToNewTouchTarget置为true,也即是说,如果有子View消耗掉了事件,那么mFirstTouchTarget就会指向该子View。
小结:
- 整个if(!canceled && !intercepted){ … }代码块所做的工作就是对ACTION_DOWN事件的特殊处理;
- 因为ACTION_DOWN事件是一个事件序列的开始,所以我们要先找到能够处理这个事件序列的一个子View;
- 如果一个子View能够消耗事件,那么mFirstTouchTarget会指向该子View;
- 如果所有的子View都不能消耗事件,那么mFirstTouchTarget将为null。
对除了ACTION_DOWN之外的其他事件的处理
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
...
// 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 {
// Dispatch to touch targets, excluding the new touch target if we already
// dispatched to it. Cancel touch targets if necessary.
TouchTarget predecessor = null;
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;
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;
}
}
...
return handled;
}
}
- 首先mFirstTouchTarget为null就调用dispatchTransformedTouchEvent(ev, canceled, null, ...)方法,这里第三个参数为null,在这个方法的内部会执行super.dispatchTouchEvent(event) - 也就是说,如果找不到子View来处理事件,那么最后会交由ViewGroup来处理事件;
- 如果mFirstTouchTarget不为null,说明在ACTION_DOWN事件时已经找到了一个子View来消耗事件,接下来往下执行if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget),这里就是区分了ACTION_DOWN事件和别的事件的关键:
如果为true那就说明是ACTION_DOWN事件,并且子View消耗了事件,那么直接置handled为true并返回;
如果为false那就说明不是ACTION_DOWN事件,即是ACTION_MOVE、ACTION_UP等别的事件。
小结:
- 最后这段代码处理除了ACTION_DOWN事件之外的其他事件;
- 如果ViewGroup拦截了事件或者所有子View均不消耗事件那么在这里交由ViewGroup处理事件;
- 如果有子View已经消耗了ACTION_DOWN事件,那么在这里继续把其他事件分发给子View处理。
我们总结一下:
-
Android
事件分发是先传递到ViewGroup
,再由ViewGroup
传递到View
的; - 在
ViewGroup
中可以通过onInterceptTouchEvent
方法对事件传递进行拦截,返回true
代表不允许事件继续向子View
传递,返回false
代表不对事件进行拦截,默认返回false
; - 当
ViewGroup
决定拦截事件后,onInterceptTouchEvent
方法将不会被调用,并且同一序列中的其他事件都会默认交给它处理; - 如果事件能够传递到当前的
ViewGroup
,且我们要提前处理所有点击事件,应该选择dispatchTouchEvent
方法,因为只有这个方法能确保每次都会被调用,而onInterceptTouchEvent
方法却无法保证每次事件都会被调用; - 子
View
可以通过调用getParent().requestDisallowInterceptTouchEvent(true)
阻止ViewGroup
对其ACTION_MOVE
或者ACTION_UP
事件进行拦截,它通常用于解决滑动冲突问题; - 子
View
不能通过调用getParent().requestDisallowInterceptTouchEvent(true)
阻止ViewGroup
对其ACTION_DOWN
事件进行拦截,因为父View在每次接收到ACTION_DOWN
事件时都会重置这个标志; - 子
View
中如果将传递的事件消费掉,ViewGroup
就不再对该事件进行处理了; -
ViewGroup
的dispatchTouchEvent
是真正在执行“分发”工作,而View
的dispatchTouchEvent
方法,并不执行分发工作,或者说它分发的对象就是自己,决定是否把touch
事件交给自己处理,而处理的方法,便是onTouchEvent
事件; - 一般情况下,我们不该在普通
View
内重写dispatchTouchEvent
方法,因为它并不执行分发逻辑。当Touch
事件到达View
时,我们该做的就是是否在onTouchEvent
事件中处理它; -
ViewGroup
的onTouchEvent
事件是什么时候处理的呢?当ViewGroup
所有的子View
都返回false时,onTouchEvent
事件便会执行。由于ViewGroup
是继承于View
的,它其实也是通过调用View
的dispatchTouchEvent
方法来执行onTouchEvent
事件; - 当某个子
View
返回true
时,会中止ACTION_DOWN
事件的分发,同时在ViewGroup
中记录该子View
。接下去的ACTION_MOVE
和ACTION_UP
事件将由该子View
直接进行处理。由于子View
是保存在ViewGroup
中的,多层ViewGroup
的节点结构时,上级ViewGroup
保存的会是真实处理事件的View
所在的ViewGroup
对象:如ViewGroup0-ViewGroup1-TextView
的结构中,TextView
返回了true
,它将被保存在ViewGroup1
中,而ViewGroup1
也会返回true
,被保存在ViewGroup0
中。当ACTION_MOVE
和ACTION_UP
事件来时,会先从ViewGroup0
传递至ViewGroup1
,再由ViewGroup1
传递至TextView
; - 当
ViewGroup
中所有子View
都不捕获ACTION_DOWN
事件时,将触发ViewGroup
自身的onTouch
事件。触发的方式是调用super.dispatchTouchEvent
函数,即父类View
的dispatchTouchEvent
方法。在所有子View
都不处理的情况下,触发Acitivity
的onTouchEvent
方法;