所谓事件分发,就是对 MotionEvent 的分发过程,当一个 MotionEvent 产生了以后,系统需要把这个事件传递给一个具体的 View,而这个传递的过程就是分发过程。引用一个《Android 开发艺术探索》里的概念:
同一个事件序列是指手指接触屏幕的那一刻起,到手指离开屏幕的那一刻结束,在这个工程中所产生的一系列事件,这个事件序列以down事件开始,中间含有数量不定的move事件,最终以up事件结束。
一个事件产生之后在应用层首先到达 ViewRootImpl 它将事件交给了 DecorView 它又将事件交给了 Window.Callback (Activity/Dialog)Activity 又将事件交给了 Window 的唯一实现类 PhoneWindow 最后又交给了 DecorView 真正的开始 View 层面的事件分发
// android.app.Activity#dispatchTouchEvent
public boolean dispatchTouchEvent(MotionEvent ev) {
if (ev.getAction() == MotionEvent.ACTION_DOWN) {
// 每次 ACTION_DOWN 事件都会调用 onUserInteraction 默认空实现
onUserInteraction();
}
if (getWindow().superDispatchTouchEvent(ev)) {
return true;
}
return onTouchEvent(ev);
}
window又交给了mDecor处理
// com.android.internal.policy.PhoneWindow#superDispatchTouchEvent
public boolean superDispatchTouchEvent(MotionEvent event) {
return mDecor.superDispatchTouchEvent(event);
}
mDecor是一个继承了FrameLayout的对象,它会调用ViewGroup的dispatchTouchEvent,真正干活的是ViewGroup同学
// com.android.internal.policy.DecorView#superDispatchTouchEvent
public boolean superDispatchTouchEvent(MotionEvent event) {
return super.dispatchTouchEvent(event);
}
下面来看看这位同学
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();
}
ACTION_DOWN 的时候把上一个事件序列修改的变量置为默认状态,包括重置子控件通过requestDisallowInterceptTouchEvent 方法设置的不让父控件拦截它的状态
// intercepted 代表父控件是否拦截事件 true 代表拦截 false 不拦截
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;
}
满足 actionMasked == MotionEvent.ACTION_DOWN 或 mFirstTouchTarget != null 的其中一个条件时才可能会调用 onInterceptTouchEvent 方法判断是否需要拦截事件,两个条件都不满足则直接拦截事件 mFirstTouchTarget != null 表示子控件处理了上一次的事件,在子控件处理消费了事件的时候会对 mFirstTouchTarget 赋值并且 mFirstTouchTarget.child 就是消费了事件的控件
事件序列以一个 ACTION_DOWN 开始,所以会进入 if 里,disallowIntercept 的值代表子控件是否告诉了 ViewGroup 不拦截事件,但是上面已经清除了这个状态,所以这里一定为 false,所以 intercepted 的值取决于 onInterceptTouchEvent 方法 默认是 false
// android.view.ViewGroup#onInterceptTouchEvent
public boolean onInterceptTouchEvent(MotionEvent ev) {
// 这里是鼠标相关
if (ev.isFromSource(InputDevice.SOURCE_MOUSE)
&& ev.getAction() == MotionEvent.ACTION_DOWN
&& ev.isButtonPressed(MotionEvent.BUTTON_PRIMARY)
&& isOnScrollbarThumb(ev.getX(), ev.getY())) {
return true;
}
return false;
}
如果 ViewGroup 要处理事件需要重写这个方法,而且如果子控件没有在 ACTION_DOWN 中消耗事件的话 mFirstTouchTarget != null 不成立,在整个事件序列的其他事件中 ViewGroup 不再判断 onInterceptTouchEvent 直接拦截事件子控件再也收不到后续事件
// android.view.ViewGroup#dispatchTouchEvent
final int childrenCount = mChildrenCount;
if (newTouchTarget == null && childrenCount != 0) {
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.
final ArrayList<View> preorderedList = buildTouchDispatchChildList();
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
for (int i = childrenCount - 1; i >= 0; i--) {
final int childIndex = getAndVerifyPreorderedIndex(
childrenCount, i, customOrder);
final View child = getAndVerifyPreorderedView(
preorderedList, children, childIndex);
// 省略代码
// 标记一
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
ev.setTargetAccessibilityFocus(false);
continue;
}
// 省略代码
// 标记二
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
// Child wants to receive touch within its bounds.
mLastTouchDownTime = ev.getDownTime();
if (preorderedList != null) {
// childIndex points into presorted list, find original index
for (int j = 0; j < childrenCount; j++) {
if (children[childIndex] == mChildren[j]) {
mLastTouchDownIndex = j;
break;
}
}
} else {
mLastTouchDownIndex = childIndex;
}
mLastTouchDownX = ev.getX();
mLastTouchDownY = ev.getY();
newTouchTarget = addTouchTarget(child, idBitsToAssign);
alreadyDispatchedToNewTouchTarget = true;
break;
}
// The accessibility focus didn't handle the event, so clear
// the flag and do a normal dispatch to all children.
ev.setTargetAccessibilityFocus(false);
}
if (preorderedList != null) preorderedList.clear();
}
标记一处 canViewReceivePointerEvents 用来判断是否正在播放动画,isTransformedTouchPointInView 用来判断点击事件的坐标是否落在子元素的区域内。满足条件处理事件,不满足遍历下一个子控件
标记二处是满足了上面的两个条件调用 dispatchTransformedTouchEvent 方法主要在这里
// android.view.ViewGroup#dispatchTransformedTouchEvent
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
View child, int desiredPointerIdBits) {
final boolean handled;
// 省略代码
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);
}
// Done.
transformedEvent.recycle();
return handled;
}
如果 child 不为空,调用 child 的 dispatchTouchEvent 方法 child 继续分发事件
如果 child 为空调用 super.dispatchTouchEvent 自己处理事件。
这里看下 child 不为空的情况,事件交给了 child 去处理,如果 child 消费了事件返回了 true,mFirstTouchTarget 被赋值
// android.view.ViewGroup#addTouchTarget
private TouchTarget addTouchTarget(@NonNull View child, int pointerIdBits) {
final TouchTarget target = TouchTarget.obtain(child, pointerIdBits);
target.next = mFirstTouchTarget;
mFirstTouchTarget = target;
return target;
}
可以看出 TouchTarget 是一个链表的数据结构,返回 mFirstTouchTarget 赋值给newTouchTarget 循环结束
// android.view.ViewGroup#dispatchTouchEvent
// 标记三
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;
}
}
标记三处 mFirstTouchTarget == null 有三种情况
其一,ViewGroup 没有子控件
其二,ViewGroup 拦截子控件
其三,事件分发给了子控件,子控件没有消费事件,返回了 false
上面 dispatchTransformedTouchEvent 返回 true 子控件消费了事件的话执行标记四,之后事件序列的其他事件不需要再去循环遍历子控件,直接执行标记五处的dispatchTransformedTouchEvent 避免每次都遍历所有子控件,另外如果后续 ViewGroup 又拦截了事件那么这里的 intercepted 就为 true 所以 cancelChild 也为 true 在 dispatchTransformedTouchEvent 方法里就会发送一个 ACTION_CANCEL 事件给之前消费事件的子控件让子控件来做一些重置工作
ViewGroup 就结束了下面看 View
ViewGroup 在分发事件的时候会分发给 View 的 dispatchTouchEvent
// android.view.View#dispatchTouchEvent
public boolean dispatchTouchEvent(MotionEvent event) {
// 省略代码
if (onFilterTouchEventForSecurity(event)) {
if ((mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)) {
result = true;
}
//noinspection SimplifiableIfStatement
ListenerInfo li = mListenerInfo;
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 的 dispatchTouchEvent 比较简单 handleScrollBarDragging 主要是鼠标的处理返回 false所以是否执行 onTouchEvent 取决于 onTouch 的返回结果
如果设置了 mOnTouchListener 并且返回值为 true 直接返回结果,然后当前 MotionEvent 就结束了,接着处理下一个MotionEvent,onClick,onLongClick 都没机会执行了。
如果不设置 mOnTouchListener 或者 onTouch 的返回值为 false 接着执行 onTouchEvent
// android.view.View#onTouchEvent
public boolean onTouchEvent(MotionEvent event) {
// 省略
final boolean clickable = ((viewFlags & CLICKABLE) == CLICKABLE
|| (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
|| (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE;
if ((viewFlags & ENABLED_MASK) == DISABLED) {
if (action == MotionEvent.ACTION_UP && (mPrivateFlags & PFLAG_PRESSED) != 0) {
setPressed(false);
}
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
// A disabled view that is clickable still consumes the touch
// events, it just doesn't respond to them.
return clickable;
}
if (mTouchDelegate != null) {
if (mTouchDelegate.onTouchEvent(event)) {
return true;
}
}
// 省略
}
View 的 LONG_CLICKABLE 默认为 false,部分 View 的 CLICKABLE 为 true,部分 View 的CLICKABLE 为 false 当 setOnClickListener 或者 setOnLongClickListener 的时候都会先置为true
如果 View 是 DISABLED 状态并且设置了允许在 DISABLED 状态下响应点击事件返回值是 clickable 如果为 true 的话即使 DISABLED 状态也会消费事件
如果有设置 TouchDelegate 则调用其 onTouchEvent 方法
如果 clickable 为 true 或者设置了tooltipText 属性 onTouchEvent 返回值默认 true 如果两者都不满足则返回 false 不消费事件
// android.view.View#onTouchEvent
case MotionEvent.ACTION_DOWN:
if (event.getSource() == InputDevice.SOURCE_TOUCHSCREEN) {
mPrivateFlags3 |= PFLAG3_FINGER_DOWN;
}
mHasPerformedLongPress = false;
// 省略代码
boolean isInScrollingContainer = isInScrollingContainer();
if (isInScrollingContainer) {
// 设置为PFLAG_PREPRESSED状态,代表按下之前的状态
mPrivateFlags |= PFLAG_PREPRESSED;
if (mPendingCheckForTap == null) {
mPendingCheckForTap = new CheckForTap();
}
mPendingCheckForTap.x = event.getX();
mPendingCheckForTap.y = event.getY();
// 延迟发送一个CheckForTap,CheckForTap负责将状态再重置回来,然后再发送一个长按的延迟事件
postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
} else {
// 直接发送一个延时的长按事件,如果在延迟时间内没有被取消,则回调onLongClick
setPressed(true, x, y);
checkForLongClick(0, x, y);
}
ACTION_DOWN 里判断是否在一个可滚动的 ViewGroup 里,这里会递归判断所有的ViewGroup
如果在一个可滚动的 ViewGroup 里延迟发送一个 CheckForTap,CheckForTap 负责将状态再重置回来,然后再发送一个长按的延迟事件。不在可滚动的 ViewGroup 直接发送一个延时的长按事件,如果在延迟时间内没有被取消,则回调 onLongClick。setPressed 用来处理 View 的状态,按下,需不需要重绘
private static final int DEFAULT_LONG_PRESS_TIMEOUT = 500;
onLongClick 的默认响应时间是 500 毫秒
case MotionEvent.ACTION_MOVE:
// 省略
if (!pointInView(x, y, mTouchSlop)) {
// Outside button
// Remove any future long press/tap checks
removeTapCallback();
removeLongPressCallback();
if ((mPrivateFlags & PFLAG_PRESSED) != 0) {
setPressed(false);
}
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
}
break;
ACTION_MOVE比较简单,如果事件在控件范围外,移除所有延迟消息
case MotionEvent.ACTION_UP:
// 如果mPrivateFlags不为0,预按下或者按下状态
boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
// 如果允许获取焦点,并且当前没有获取到焦点
boolean focusTaken = false;
if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
// 获取焦点
focusTaken = requestFocus();
}
if (prepressed) {
// 置为按下状态,重绘
setPressed(true, x, y);
}
if (!mHasPerformedLongPress && !mIgnoreNextUpEvent) {
// 如果长按没有触发,说明是点击事件,移除长按
removeLongPressCallback();
// Only perform take click actions if we were in the pressed state
if (!focusTaken) {
// 在这里回调onClick事件
if (mPerformClick == null) {
mPerformClick = new PerformClick();
}
if (!post(mPerformClick)) {
performClick();
}
}
}
// 用来设置view不同状态下的背景
if (mUnsetPressedState == null) {
mUnsetPressedState = new UnsetPressedState();
}
if (prepressed) {
postDelayed(mUnsetPressedState,
ViewConfiguration.getPressedStateDuration());
} else if (!post(mUnsetPressedState)) {
// If the post failed, unpress right now
mUnsetPressedState.run();
}
// 移除点击
removeTapCallback();
}
mIgnoreNextUpEvent = false;
break;
ACTION_UP 比较长用注释的方式解释了,主要是判断长按事件有没有回调,没有说明从 DOWN 事件到 UP 事件不到 500 毫秒移除长按回调 onClick 事件设置 View 不同状态下的背景事件就结束了
case MotionEvent.ACTION_CANCEL:
if (clickable) {
setPressed(false);
}
removeTapCallback();
removeLongPressCallback();
mInContextButtonPress = false;
mHasPerformedLongPress = false;
mIgnoreNextUpEvent = false;
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
break;
ACTION_CANCEL 当父控件在 DOWN 事件没有拦截事件交给了子控件处理之后又拦截了事件则会递归发送一个 CANCEL 事件给上一次消费了事件的控件取消所有回调重置所有状态
onTouchEvent 执行结束,默认返回 true 消耗事件,然后返回到 ViewGroup 的dispatchTouchEvent 层层返回,最后回到 Activity 的 dispatchTouchEvent 中
// android.app.Activity#dispatchTouchEvent
public boolean dispatchTouchEvent(MotionEvent ev) {
if (ev.getAction() == MotionEvent.ACTION_DOWN) {
onUserInteraction();
}
if (getWindow().superDispatchTouchEvent(ev)) {
return true;
}
return onTouchEvent(ev);
}
一般情况下 getWindow().superDispatchTouchEvent(ev) 都为 true 事件分发结束如果所有的 View 都没有消费事件,最后由 Activity 的 onTouchEvent 处理,并且在这个事件序列里的事件都不会再发送到任何一个控件
总结
- 如果所有控件都不消费事件则除第一个事件 ACTION_DOWN 外同一个事件序列里的其他事件都收不到了最后事件会交给 Activity 处理
- 如果有控件消费了 ACTION_DOWN 事件会把这个控件记录下来同一个事件序列里的后续事件不再遍历所有控件而是直接传递给这个控件
- 如果在同一个事件序列里父控件没有拦截 ACTION_DOWN 事件被子控件消费之后又拦截了事件那么子控件会收到一个 ACTION_CANCEL 事件
- 解决事件冲突的方式有两种,一种是外部拦截父控件通过重写 onInterceptTouchEvent 方法决定在不同的时机是否拦截事件(不能拦截 ACTION_DOWN 事件否则子控件收不到后续的其他事件)另一种是在子控件中重写 dispatchTouchEvent 方法决定在不同的时机调用 requestDisallowInterceptTouchEvent 方法让父控件拦截/不拦截事件(同样父控件不能拦截 ACTION_DOWN 事件并且此方法对 ACTION_DOWN 无效)
- OnTouchListener 的回调时机先于 onTouchEvent 方法并且如果 onTouch 事件返回 true 的话 onTouchEvent 就不会执行了
- 点击、长按事件是在 onTouchEvent 方法的 ACTION_UP 事件里触发的所以如果控件收不到 ACTION_UP 事件就不会回调点击、长按事件