屏幕接受到一个触摸事件,首先由系统回调Activity中的dispatchTouchEvent方法
public boolean dispatchTouchEvent(MotionEvent ev) {
// 对一组事件来说,首先要处理DOWN事件
if (ev.getAction() == MotionEvent.ACTION_DOWN) {
// 是一个空方法,供用户自己实现自己的逻辑
onUserInteraction();
}
if (getWindow().superDispatchTouchEvent(ev)) {
return true;
}
return onTouchEvent(ev);
}
如果执行getWindow().superDispatchTouchEvent(ev)
返回了true,那么就不会调用自己的onTouchEvent方法。否则,就会执行onTouchEvent。关键是看getWindow().superDispatchTouchEvent(ev)
的返回值了。此方法直接调用了此acitivty所属的phoneWindow中mDecor的superDispatchTouchEvent方法。而mDecor直接调用了它父类中的dispatchTouchEvent方法
// 这是一个ViewGroup的成员变量,TouchTarget是ViewGroup的内部类,这个类是一个单链表数据结构,
// 这个类内部保存着对一个View的引用。其实它的主要职责就是形成一个View的单链表集合
// mFirstTouchTarget就是在这个链表集合中保存第一个触摸的VIew
private TouchTarget mFirstTouchTarget;
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
// a.对事件的检测
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(ev, 1);
}
// b.处理accessibility相关的逻辑
if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) {
ev.setTargetAccessibilityFocus(false);
}
boolean handled = false;
// c. 过滤安全的事件,一般情况下都会返回true
if (onFilterTouchEventForSecurity(ev)) {
final int action = ev.getAction();
final int actionMasked = action & MotionEvent.ACTION_MASK;
// d.mask为down,表明是一组新的事件,当前为down事件
if (actionMasked == MotionEvent.ACTION_DOWN) {
// 清除和复位上一组事件的所有标记以及变量,以备开始一个新的循环
cancelAndClearTouchTargets(ev);
resetTouchState();
}
// e.定义一个boolean变量,表示是否拦截
final boolean intercepted;
// f.此次事件为down或者 mFirstTouchTarget已经被赋值了
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {
// g.子view是否请求父控件拦截此次事件
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
if (!disallowIntercept) {
// h.子view没有请求父控件拦不拦截,所以走正常逻辑
intercepted = onInterceptTouchEvent(ev);
ev.setAction(action);
} else {
// i.子view请求父控件不要拦截此次事件,所以intercepted直接赋值为false
intercepted = false;
}
} else {
// j. mFirstTouchTarget为null或者此时的acition不是down,此时需要拦截
intercepted = true;
}
if (intercepted || mFirstTouchTarget != null) {
ev.setTargetAccessibilityFocus(false);
}
// k.检查是否取消
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;
final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
TouchTarget newTouchTarget = null;
boolean alreadyDispatchedToNewTouchTarget = false;
// l.如果没有取消此次事件并且不拦截此次事件,那就意味着要把此次事件交给子view
if (!canceled && !intercepted) {
View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus()
? findChildWithAccessibilityFocus() : null;
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;
removePointersFromTouchTargets(idBitsToAssign);
final int childrenCount = mChildrenCount;
if (newTouchTarget == null && childrenCount != 0) {
final float x = ev.getX(actionIndex);
final float y = ev.getY(actionIndex);
// m.遍历所有children,对子view进行针对触摸事件的排序
final ArrayList preorderedList = buildTouchDispatchChildList();
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
// n.遍历所有children
for (int i = childrenCount - 1; i >= 0; i--) {
final int childIndex = getAndVerifyPreorderedIndex(
childrenCount, i, customOrder);
final View child = getAndVerifyPreorderedView(
preorderedList, children, childIndex);
if (childWithAccessibilityFocus != null) {
if (childWithAccessibilityFocus != child) {
continue;
}
childWithAccessibilityFocus = null;
i = childrenCount - 1;
}
// o.当前遍历的view不能接受到手指触摸事件(View当前不是VISIBLE状态
// 或者view当前只在执行动画),或者当前的触摸点不在这个View上
// 都需要continue,不必在执行下面的代码,而是去遍历下一个View
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
ev.setTargetAccessibilityFocus(false);
continue;
}
// p.代码能执行到这里,说明此View有必要相应这个事件
// 检查child在链表中是否存在。如果存在返回,否则返回null
// 如果是一组新事件,当前是down,那么newTouchTarget必定返回null
newTouchTarget = getTouchTarget(child);
// q.
if (newTouchTarget != null) {
newTouchTarget.pointerIdBits |= idBitsToAssign;
break;
}
resetCancelNextUpFlag(child);
// r.
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
mLastTouchDownTime = ev.getDownTime();
if (preorderedList != null) {
for (int j = 0; j < childrenCount; j++) {
if (children[childIndex] == mChildren[j]) {
mLastTouchDownIndex = j;
break;
}
}
} else {
mLastTouchDownIndex = childIndex;
}
mLastTouchDownX = ev.getX();
mLastTouchDownY = ev.getY();
// s.将当前view封装成一个TouchTarget对象,并把这个TouchTarget
// 对象加入到链表中。将mFirstTouchTarget指向了这个对象,并返回
newTouchTarget = addTouchTarget(child, idBitsToAssign);
alreadyDispatchedToNewTouchTarget = true;
break;
}
ev.setTargetAccessibilityFocus(false);
}
if (preorderedList != null) preorderedList.clear();
}
// t.没有找到能处理此次事件的view并且mFirstTouchTarget !=null,
// 把此次事件指派给链表的最后一个touchTarget处理
if (newTouchTarget == null && mFirstTouchTarget != null) {
newTouchTarget = mFirstTouchTarget;
while (newTouchTarget.next != null) {
newTouchTarget = newTouchTarget.next;
}
newTouchTarget.pointerIdBits |= idBitsToAssign;
}
}
}
if (mFirstTouchTarget == null) {
// u.没有touchTarget能处理事件,那还是本viewGroup自己来处理这次事件吧
handled = dispatchTransformedTouchEvent(ev, canceled, null,
TouchTarget.ALL_POINTER_IDS);
} else {
TouchTarget predecessor = null;
TouchTarget target = mFirstTouchTarget;
while (target != null) {
final TouchTarget next = target.next;
// v.这个if语句成立的条件就是执行了注释编号r的if语句块,那个语句块中确实消费了事件,
// 所以这里的handled直接赋值为了true
if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
handled = true;
} else {
final boolean cancelChild = resetCancelNextUpFlag(target.child)
|| intercepted;
// w.事件分发下去
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;
}
}
if (canceled
|| actionMasked == MotionEvent.ACTION_UP
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
resetTouchState();
} else if (split && actionMasked == MotionEvent.ACTION_POINTER_UP) {
final int actionIndex = ev.getActionIndex();
final int idBitsToRemove = 1 << ev.getPointerId(actionIndex);
removePointersFromTouchTargets(idBitsToRemove);
}
}
if (!handled && mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onUnhandledEvent(ev, 1);
}
return handled;
}
此方法逻辑比较复杂,理解此方法是理解事件分发机制的关键。可以说此方法弄明白了,事件分发的机制也就弄明白了。
模拟一个场景,一个activity中仅包含一个ViewGroup,这个ViewGroup又仅仅包含一个View。现在假设执行了从屏幕上滑动了一段距离的操作。
其他什么都保持不变
- 1 mDecor执行其父类ViewGroup中的dispatchTouchEvent
- 2 首先响应这组事件中的down事件,所以会进入到注释编号f的代码块中,此时disallowIntercept 为false,所以会执行
intercepted = onInterceptTouchEvent(ev);
intercepted被赋值为false。 - 3 进入注释标号为l的if语句块中,执行到注释编号为p的代码时
private TouchTarget getTouchTarget(@NonNull View child) {
for (TouchTarget target = mFirstTouchTarget; target != null; target = target.next) {
if (target.child == child) {
return target;
}
}
return null;
}
由于此时mFirstTouchTarget为null,所以返回null。向下继续执行,由于newTouchTarget ==null,所以不会进入q中
- 4 执行到编号为r处执行
dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
View child, int desiredPointerIdBits) {
final boolean handled;
// ......
final MotionEvent transformedEvent;
if (newPointerIdBits == oldPointerIdBits) {
if (child == null || child.hasIdentityMatrix()) {
if (child == null) {
handled = super.dispatchTouchEvent(event);
} else {
final float offsetX = mScrollX - child.mLeft;
final float offsetY = mScrollY - child.mTop;
event.offsetLocation(offsetX, offsetY);
handled = child.dispatchTouchEvent(event);
event.offsetLocation(-offsetX, -offsetY);
}
return handled;
}
transformedEvent = MotionEvent.obtain(event);
} else {
transformedEvent = event.split(newPointerIdBits);
}
if (child == null) {
handled = super.dispatchTouchEvent(transformedEvent);
} else {
final float offsetX = mScrollX - child.mLeft;
final float offsetY = mScrollY - child.mTop;
transformedEvent.offsetLocation(offsetX, offsetY);
if (! child.hasIdentityMatrix()) {
transformedEvent.transform(child.getInverseMatrix());
}
handled = child.dispatchTouchEvent(transformedEvent);
}
transformedEvent.recycle();
return handled;
}
此方法很重要,但是逻辑很简单。就是如果child==null,就调用super.dispatchTouchEvent(event);
;否则调用child.dispatchTouchEvent(event);
,所以会进入view的dispatchTouchEvent方法。
public boolean dispatchTouchEvent(MotionEvent event) {
boolean result = false;
if (onFilterTouchEventForSecurity(event)) {
if (li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
&& li.mOnTouchListener.onTouch(this, event)) {
result = true;
}
if (!result && onTouchEvent(event)) {
result = true;
}
}
return result;
}
省略的其他代码,可以清晰的看到,只有该View的OnTouchListener的onTouch方法和它的onTouchEvent方法返回true,result才会为true,否则就会返回false。此情景中view调用dispatchTouchEvent的返回值应为false,所以ViewGroup中的dispatchTransformedTouchEvent也返回了false。不会进入编号r中的if块中。
- 5 程序继续向下执行,会进入到编号为u的代码处,
handled = dispatchTransformedTouchEvent(ev, canceled, null,TouchTarget.ALL_POINTER_IDS);
还是执行dispatchTransformedTouchEvent方法,只是这次child参数为null了,按照此方法的逻辑,会调用它自己父类中的dispatchTouchEvent方法,会依然返回false。所以在u处handled被赋值为false。至此,ViewGroup中的一次dispatchTouchEvent执行完毕,并返回了false。 - 6 activity#dispatchTouchEvent的
getWindow().superDispatchTouchEvent(ev)
返回了false,所以执行了activity的onTouchEvent方法。 - 7 刚刚仅仅是一次down的操作,此时又有一系列move事件触发。同样通过mDecor执行其父类ViewGroup中的dispatchTouchEvent
- 8 执行到f代码处,由于不符合if的成立条件,所以intercepted被赋值为ture;代码直接执行到了u处,同样会返回false,同样最终也会调用activity的onTouchEvent。
这次设置最里层view的onTouchListener的onTouch返回值为true
- 1 前面的流程与上面的1、2、3的步骤一模一样。只是在第4步中调用
child.dispatchTouchEvent(event);
时,由于此时child的onTouch返回了true,所以dispatchTransformedTouchEvent也返回了true。进入了if语句中,执行了newTouchTarget = addTouchTarget(child, idBitsToAssign);
- 2 程序向下执行,走到了编号v处,ViewGroup中的一次dispatchTouchEvent执行down操作结束,并返回了true。
- 3 activity#dispatchTouchEvent的
getWindow().superDispatchTouchEvent(ev)
返回了true,不执行activity的onTouchEvent方法了。 - 4 接着触发一系列的move事件,接着执行ViewGroup中的dispatchTouchEvent
- 5 执行到f处,由于mFirstTouchTarget已经不为null了,所以进入if语句。执行h,intercepted被赋值为false。
- 6 进入l处的if语句,在执行
newTouchTarget = getTouchTarget(child);
后,newTouchTarget 这时已经不为null了,已经找到了处理事件的touchTarget,所以直接break - 7 按照流程直接会走到w处去分发事件,执行
dispatchTransformedTouchEvent(ev, cancelChild,target.child, target.pointerIdBits)
,此时返回值会为true,所以handled为true。 - 8 同理,Activity#onTouchEvent不执行
重写ViewGroup的onInterceptTouchEvent返回值为true,并让onTouchEvent返回值也为true
- 1 前面的流程与第一种情况的1、2、3步骤一样。当代码执行到编号r的注释处执行
child.dispatchTouchEvent(event);
时,当遍历传入的child为ViewGroup时,会执行这个ViewGroup的dispatchTouchEvent - 2 又会依次执行 a,b,c,d,e,f,g代码,执行到h时,由于此ViewGroup的onInterceptTouchEvent方法返回了true,所以intercepted被赋值为true
- 3 代码就会直接执行编号为u的代码,执行了此VIewGroup自己父类的dispatchTouchEvent。去执行了它自己的onTouchEvent,并返回了true,所以此VIewGroup的dispatchTouchEvent方法也返回了true。
- 4 那么在mDeocr调用的dispatchTouchEvent方法中,编号为r处的代码返回了true,所以进入此次if语句块
- 5 接着执行v处代码,handled被赋值为true,表明此次事件被消耗掉了,所以Activity#onTouchEvent没被调用
- 6 接着又来了一系列的move事件,会依次执行a b c e f h , intercepted被赋值为false.
- 7 进入标号l注释中,执行p后,newTouchTarget 不为null,取出了谁要处理此次事件,break
- 8 运行w处代码,将向下分发事件,此处的child就为viewGroup,调用了viewGroup的dispatchTouchEvent,然后是onTouchEvent,返回true。所以mDeocr中的dispatchTouchEvent返回的是true,依然不会调用Activity#onTouchEvent方法
- 9 up事件同理
其他情况也都一样,只要理解了dispatchTouchEvent的逻辑,也就理解了事件分发的逻辑