技术背景
从 View 体系中认识 Touch 事件传递,暂时留一条线索:
" View 最原始的事件从哪里来? ”
从 WindowCallbacKWrapper开始的。
那么,我们开始吧!
tip:阅读源码前,建议读懂 Android View体系之基础常识及技巧。
千里之行,始于Activity
从 window
层开始下发事件后, Activity
开始处理事件,会调用 ViewGroup#dispatchTouchEvent
Activity.java
public boolean dispatchTouchEvent(MotionEvent ev) {
if (ev.getAction() == MotionEvent.ACTION_DOWN) {
onUserInteraction();
}
if (getWindow().superDispatchTouchEvent(ev)) {
return true;
}
return onTouchEvent(ev);
}
PhoneWindow.java
@Override
public boolean superDispatchTouchEvent(MotionEvent event) {
return mDecor.superDispatchTouchEvent(event);
}
DecorView.java
public boolean superDispatchTouchEvent(MotionEvent event) {
return super.dispatchTouchEvent(event);
}
ViewGroup.java
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
...
}
总结:
方法最后会通过 Activity
下发 Touch
事件到 DecorView
并由 DecorView
开始向下传递。Activity#dispatchTouchEventDecorView
触发 ViewGroup#dispatchTouchEvent
开始分发事件。
ViewGroup之核心分发
DecorView
调用 dispatchTouchEvent
分发 Touch
事件。代码很长,可是不难,逻辑比较清晰。
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
//默认不下发 Touch 事件
boolean handled = false;
// 1. 检测是否分发Touch事件(判断窗口是否被遮挡住)
// 如果该 Touch 事件没有被窗口遮挡,则继续下面逻辑
if (onFilterTouchEventForSecurity(ev)) {
// 获取 Touch Action
final int action = ev.getAction();
final int actionMasked = action & MotionEvent.ACTION_MASK;
// 2. 判断是否是ACTION_DOWN事件
// 清空所有接收触摸事件View的引用
// 重置触摸状态
// 设置mGroupFlags &= ~FLAG_DISALLOW_INTERCEPT,默认允许拦截事件
// 设置mNestedScrollAxes = SCROLL_AXIS_NONE,默认视图不滚动
if (actionMasked == MotionEvent.ACTION_DOWN) {
cancelAndClearTouchTargets(ev);
resetTouchState();
}
//3. 判断事件是否需要拦截 - intercepted
//判断是否允许拦截
//如果允许拦截,则通过 onInterceptTouchEvent 方法返回
//子类可以通过requestDisallowInterceptTouchEvent(boolean disallowIntercept)方法
//传入true,请求父类不拦截事件(|FLAG_DISALLOW_INTERCEPT)
final boolean intercepted;
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
//disallowIntercept=false,表示允许父类拦截
if (!disallowIntercept) {
intercepted = onInterceptTouchEvent(ev);
ev.setAction(action); // restore action in case it was changed
} else {
//父类不拦截
intercepted = false;
}
} else {
//actionMasked != MotionEvent.ACTION_DOWN && mFirstTouchTarget == null
//说明当前传递的事件不是ACTION_DOWN,mFirstTouchTarget==null
//意味着ACTION_DOWN已经被拦截过了,子View里面没有View处理过ACTION_DOWN。
intercepted = true;
}
// 4. 判断事件是否是取消事件 - canceled
// 如果 view.mPrivateFlags 标志被设置 PFLAG_CANCEL_NEXT_UP_EVENT,则该 view 已经脱离视图
// 如果 当前标志为 PFLAG_CANCEL_NEXT_UP_EVENT 或者 接收 MotionEvent.ACTION_CANCEL 事件,返回 true
// 也就是说,如果View detach时,则canceled返回true
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;
//是否支持多指触摸 (允许将MotionEvents拆分并分派给多个子视图,默认true在构造函数中设置)
//(例如RecyclerView,先在一个item上按下 ACTION_DOWN,不松开,再在另一个item上按下 ACTION_POINTER_NUM ,再同时松开2个手指,此时会触发2个点击事件(后按的先触发事件))
final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
TouchTarget newTouchTarget = null;
boolean alreadyDispatchedToNewTouchTarget = false;
// 5. 如果事件没有被取消且没有被拦截,走下面逻辑判断是否需要传递
if (!canceled && !intercepted) {
// 忽略:检测无障碍焦点
View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus()
? findChildWithAccessibilityFocus() : null;
// 6. 如果是点击事件,区分单指,多指,或者hover(类似鼠标悬浮)
// actionIndex 返回 0 ,id则:第一指id为0,第二指id为1,依次递增
// idBitsToassign,第一指为1,第二指为2,第三指4,依次指数递增
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(默认0,只有在 ACTION_POINTER_DOWN 放置多个手指时,为当前多指数量-1,比如放置第二根时为1,放置第四根时为3。后续 ACTION_MOVE 事件时都为0,无论你移动哪根手指。)
//在 ACTION_UP 时,actionIndex=min(你松开的手指的添加位置,当前多指数量-1)
//举例:一共4根,先松开第四根,再松开第三根,此时 actionIndex 分别是 3,2
//举例:一共4根,先松开第三根,再松开第四根,此时 actionIndex 分别是 2,2
final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
: TouchTarget.ALL_POINTER_IDS;
//清除当前手指触摸的历史target引用(指针id的组合位掩码,因为可能是多指触摸)
//ACTION_DOWN、ACTION_POINTER_DOWN、ACTION_HOVER_MOVE的组合,不包括ACTION_MOVE、ACTION_UP 等其他触摸事件
removePointersFromTouchTargets(idBitsToAssign);
final int childrenCount = mChildrenCount;
//存在子View
if (newTouchTarget == null && childrenCount != 0) {
final float x = ev.getX(actionIndex);
final float y = ev.getY(actionIndex);
// 7. 扫描可传递的子 View 列表,按照Z轴坐标大小从小到大(最底层-->最上层)排序返回列表 preorderedList
//(PS:Z轴坐标即View的绘制顺序,处于最上层(最后绘制)还是最底层(最先绘制),最上层先接收到事件,例如帧布局xml里面,后面的控件会覆盖前面的控件)
// 可以通过给 view 设置 elevation、translationZ 属性来控制Z轴坐标大小
// 默认 elevation=0;translationZ=0;
// 遍历子 view 列表并结合 preorderedList 找出符合绘制条件的 view
// 如果有子控件getZ!= 0, preorderedList 才不为空;如果所有子控件getZ== 0,则 preorderedList 为空
final ArrayList<View> preorderedList = buildTouchDispatchChildList();
//只有在所有子控件 getZ== 0,并且 子绘图顺序由 getChildDrawingOrder(int, int) 来定义
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
for (int i = childrenCount - 1; i >= 0; i--) {
//如果 customOrder=false,则 childIndex= i
//否则 内部调用了getChildDrawingOrder方法,获取绘制的子元素的索引
final int childIndex = getAndVerifyPreorderedIndex(
childrenCount, i, customOrder);
//根据索引,获取要绘制的子元素
//如果 preorderedList!=null,则为Z轴从小到大列表的索引
//否则,为 addView 添加顺序列表的索引
final View child = getAndVerifyPreorderedView(
preorderedList, children, childIndex);
//忽略:如果该 View 存在无障碍焦点,则跳过
if (childWithAccessibilityFocus != null) {
if (childWithAccessibilityFocus != child) {
continue;
}
childWithAccessibilityFocus = null;
i = childrenCount - 1;
}
// 8. 判断子 view 是否不可见或者不在子 view 的范围内
// 如果满足,则跳过
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
ev.setTargetAccessibilityFocus(false);
continue;
}
// 9. 遍历 target 链表,找到当前 child 对应的 target
// 如果存在,则把手指的触摸id跟pointerIdBits 位或运算
// 这个比较难理解,举个栗子。(多指触摸)
// 假如我食指按在一个 view(A) 上,然后中指在食指未起来之前又按在 view(A)
// 上,则会把后者的 idBitsToAssign 更新到指向view(A) 的 newTouchTarget 对象上
//idBitsToassign,第一指为1,第二指为2,第三指4,依次指数递增
newTouchTarget = getTouchTarget(child);
if (newTouchTarget != null) {
newTouchTarget.pointerIdBits |= idBitsToAssign;
break;
}
// 清除子 view.mPrivateFlags PFLAG_CANCEL_NEXT_UP_EVENT 标志
resetCancelNextUpFlag(child);
// 10. 返回下发 Touch 事件结果。
// 如果没有子 view,则返回 view#dispatchTouchEvent 结果,实际上这里会发生递归。
// 如果子 view 消费了 Touch 事件,则会添加到 target 链接
// 举例:如果多指触摸2个的子 view,并且都消费了,则 target 链表长度=2
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
mLastTouchDownTime = ev.getDownTime();
if (preorderedList != null) {
// childIndex points into presorted list, find original index
//找到原始 addView 添加顺序列表,原始索引
for (int j = 0; j < childrenCount; j++) {
if (children[childIndex] == mChildren[j]) {
mLastTouchDownIndex = j;
break;
}
}
} else {
mLastTouchDownIndex = childIndex;
}
//设置最后点击X、Y轴坐标
mLastTouchDownX = ev.getX();
mLastTouchDownY = ev.getY();
//添加新的触摸TouchTarget到原TouchTarget链表的开头,
//也就是说多指触摸,后按的反而在前面,举例:三根手指
//即 链表头--->链表尾 第三根--->第二根--->第一根
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();
}
// 11. 如果没有子view消费 Touch 事件且 mFirstTouchTarget 却不为 null
// 这就郁闷了,比较难理解,举个栗子。
// 前一个 if 条件是 newTouchTarget == null && childrenCount != 0
// 如果我第一根手指按在 viewGroup(A)中 textview(a)
// 同时,另一根手指按在除 textview(a)外空白区域(viewGroup(A)内)
// 第一根:因为 textview(a)消费了 Touch 事件,所以 addTouchTarget 触发,此时 mFirstTouchTarget!=null
// 第二根;没有子控件消费Touch 事件,所以 newTouchTarget=null
if (newTouchTarget == null && mFirstTouchTarget != null) {
// Did not find a child to receive the event.
// Assign the pointer to the least recently added target.
newTouchTarget = mFirstTouchTarget;
while (newTouchTarget.next != null) {
newTouchTarget = newTouchTarget.next;
}
newTouchTarget.pointerIdBits |= idBitsToAssign;
}
}
}
// 12. 如果 mFirstTouchTarget == null 意味着 没有任何 view 消费该 Touch 事件
// 则 viewGroup 会调用dispatchTransformedTouchEvent处理,因为child==null,所以会调用
// view#dispatchTouchEvent处理。
if (mFirstTouchTarget == null) {
// No touch targets so treat this as an ordinary view.
handled = dispatchTransformedTouchEvent(ev, canceled, null,
TouchTarget.ALL_POINTER_IDS);
} else {
// 13. 当前有子 view 消费了 Touch 事件
TouchTarget predecessor = null;
TouchTarget target = mFirstTouchTarget;
while (target != null) {
final TouchTarget next = target.next;
//如果当前 target是新加入(即当前action=ACTION_DOWN,并且某个子view处理了action)
//或者多指触摸情况下(action=ACTION_POINTER_DOWN,并且某个子view处理了action)
//则设置handled = true
if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
handled = true;
} else {
//是否需要向子 view 传递 ACTION_CANCEL 事件(FLAG_CANCEL_NEXT_UP_EVENT标志 或者 子View处理过事件,但后续事件被该ViewGroup拦截了(例如:子view处理了ACTION_DOWN,但ACTION_MOVE被该ViewGroup拦截了))
final boolean cancelChild = resetCancelNextUpFlag(target.child)
|| intercepted;
// 14. 递归返回事件分发结果
// 要么传递ACTION_CANCEL 事件;要么传递多指,或者hover 事件
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;
}
}
// 14. 检测是否是取消标志
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;
}
如果看完上述注释还有点蒙,一定要多撸几次源码。有几个点想说明一下,可能大家会好理解要一点。
TouchTarget mFirstTouchTarget
的作用mFirstTouchTarget
贯穿dispatchTouchEvent
流程,实际上它是一个链表,用于记录所有接受Touch
事件的 子view
。在日常开发中有没有遇到过这样一个逻辑“ 如果一个view
没有接收过ACTION_DOWN
的事件,那么后续ACTION_MOVE
和ACTION_UP
也一定不会分发到这个view
。 ”。这个逻辑是基于mFirstTouchTarget
记录的view
实现的。(从13处可以看到)
总结: 根据上述注释逻辑链。
- 过滤’不合法’的
Touch
事件; - 如果是 MotionEvent.ACTION_DOWN ,则初始化一些状态;
- 判断事件是否需要拦截,是否需要取消;
- 如果不需要拦截&不是取消事件,则会向子
view
下发Touch
事件; - 如果没有任何子
view
消费事件,则会自己处理;如果已有子view
消费事件,判断当前新处理的target
对象是否是mFirstTouchTarget
链表最新一个(即newTouchTarget==mFirstTouchTarget),如果是则默认为当前已经传递事件,返回true;否则返回子view
的递归结果。
上述有两个递归,在 注释10
和 注释14
,这里你可能会有疑惑,这两个的关系是什么。注释10
实际上是返回以 viewGroup 为根节点下的 view 是否有节点消费ACTION_DOWN事件,如果有则记录下当前子 view。注释14
实际上是返回以 viewGroup 为根节点下的 view 是否有节点消费事件。
ViewGroup之递归入口
在上一章节,dispatchTouchEvent
多次调用 dispatchTransformedTouchEvent
,这里做下简单分析。
private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
View child, int desiredPointerIdBits) {
// 1. 是否下发 Touch 事件
final boolean handled;
// 2. 如果事件传递已经取消 或者当前事件是 ACTION_CANCEL
// 如果没有子 view,则返回 view#dispatchTouchEvent
// 如果有子 view,则 返回 child#dispatchTouchEvent
final int oldAction = event.getAction();
if (cancel || oldAction == MotionEvent.ACTION_CANCEL) {
event.setAction(MotionEvent.ACTION_CANCEL);
if (child == null) {
handled = super.dispatchTouchEvent(event);
} else {
handled = child.dispatchTouchEvent(event);
}
event.setAction(oldAction);
return handled;
}
// 3. 计算当前新手指id
final int oldPointerIdBits = event.getPointerIdBits();
final int newPointerIdBits = oldPointerIdBits & desiredPointerIdBits;
if (newPointerIdBits == 0) {
return false;
}
// 4. 处理事件转化
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);
}
// 5. 返回是否传递 Touch 事件
// 如果没有子 view,则返回 view#dispatchTouchEvent
// 如果有子 view,则 返回 child#dispatchTouchEvent
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;
}
总结:dispatchTransformedTouchEvent
会对非 MotionEvent.ACTION_CANCEL
事件做转化并递归返回所有事件的下发结果。
View也可分发事件?
既然不是 view
,那么 dispatchTouchEvent
应该不是属于下发范畴的,那会是什么呢?
public boolean dispatchTouchEvent(MotionEvent event) {
//...
boolean result = false
//停止滑动
if (actionMasked == MotionEvent.ACTION_DOWN) {
// Defensive cleanup for new gesture
stopNestedScroll();
}
// 1.过滤不合法的 Touch 事件
if (onFilterTouchEventForSecurity(event)) {
// 2. 如果 view 可用且当前事件被当做拖拽事件处理,返回true
if ((mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)) {
result = true;
}
// 3. 如果 view 可用监听且 OnTouchListener 处理了 touch 事件
ListenerInfo li = mListenerInfo;
if (li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
&& li.mOnTouchListener.onTouch(this, event)) {
result = true;
}
// 4. 如果 onTouchEvent 消费了事件
if (!result && onTouchEvent(event)) {
result = true;
}
}
//...
return result;
}
上述逻辑表明有三种场景下会返回 true
结果。
两种场景为:第一种是拖拽场景,比如listview等控件存在这种逻辑;另一种是开发者设置了 OnTouchListener 对象并在 onTouch
函数中处理并返回 true
结果。
最后一种场景为普遍场景,及如果没有上述两种场景且是当前是最外层 view
时(事件已经无法再传递),则会调用自身的 onTouch
方法处理。
总结:view#dispatchTouchEvent
会在事件下发链末端调用,并把当前 view
的 onTouch
返回值作为 dispatchTouchEvent
返回值。
回看ViewGroup如何拦截
上述篇章的下发逻辑都需要判断 Touch 事件是否需要被拦截,先看看代码。
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#dispatchTouchEvent上面的代码在绝大部分情况下都返回 false
。除非是鼠标事件且在上面滚动,这个场景很像你在滚动网页一样,那么当前的页面就会拦截滚动事件进行页面滚动。
值得注意的是:如果你在该方法返回 true
进行拦截,那么你会走下面的调用逻辑:
- viewGroup#dispatchTouchEvent
- viewGroup#dispatchTransformedTouchEvent
- view#dispatchTouchEvent
- view#onTouchEvent
总结:viewGroup#onInterceptTouchEvent
是 ViewGroup 特有的方法。默认情况下 ViewGroup 不会拦截 Touch 事件,如果拦截了 Touch 事件,则会交给 View#onTouch
进行处理。
事件的宿命onTouchEvent
这个方法是处理 Touch 事件,并返回结果给 dispatchTouchEvent
的。可以理解为:它决定了某个 view
是否真正消费 Touch 事件。直接看源码。
public boolean onTouchEvent(MotionEvent event) {
final float x = event.getX();
final float y = event.getY();
final int viewFlags = mViewFlags;
final int action = event.getAction();
final boolean clickable = ((viewFlags & CLICKABLE) == CLICKABLE
|| (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
|| (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE;
// 1. 判断是否是 DISABLED 的 view
// 如果是,且已经按下之后抬起,则会消费掉 Touch 事件
if ((viewFlags & ENABLED_MASK) == DISABLED) {
if (action == MotionEvent.ACTION_UP && (mPrivateFlags & PFLAG_PRESSED) != 0) {
setPressed(false);
}
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
return clickable;
}
//2. 如果设置了 mTouchDelegate,并且mTouchDelegate.onTouchEvent(event)返回true,则会直接返回 true
if (mTouchDelegate != null) {
if (mTouchDelegate.onTouchEvent(event)) {
return true;
}
}
//3. 如果可点击或者显示了 toolTip,则会开始判断处理 Touch 事件
if (clickable || (viewFlags & TOOLTIP) == TOOLTIP) {
switch (action) {
//4. 处理 MotionEvent.ACTION_UP
case MotionEvent.ACTION_UP:
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
if ((viewFlags & TOOLTIP) == TOOLTIP) {
handleTooltipUp();
}
// 5. 显示 toolTip 时清空对应状态,返回 true
if (!clickable) {
removeTapCallback();
removeLongPressCallback();
mInContextButtonPress = false;
mHasPerformedLongPress = false;
mIgnoreNextUpEvent = false;
break;
}
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);
}
// 6. 如果调用长按行为或者且不忽略下一次事件(触笔)
// 移出长按回调
// 如果我们在按压状态下,则 post PerformClick 对象(runnable)
// 值得一提的是,PerformClick 对象的 run 方法实际上也是调用
// performClick 方法,该方法调用 view 的 onClickListener#onClick 方法
if (!mHasPerformedLongPress && !mIgnoreNextUpEvent) {
removeLongPressCallback();
if (!focusTaken) {
if (mPerformClick == null) {
mPerformClick = new PerformClick();
}
if (!post(mPerformClick)) {
performClick();
}
}
}
// 设置非按压状态
if (mUnsetPressedState == null) {
mUnsetPressedState = new UnsetPressedState();
}
if (prepressed) {
postDelayed(mUnsetPressedState,
ViewConfiguration.getPressedStateDuration());
} else if (!post(mUnsetPressedState)) {
mUnsetPressedState.run();
}
removeTapCallback();
}
mIgnoreNextUpEvent = false;
break;
// 7. 处理 MotionEvent.ACTION_DOWN 事件
case MotionEvent.ACTION_DOWN:
if (event.getSource() == InputDevice.SOURCE_TOUCHSCREEN) {
mPrivateFlags3 |= PFLAG3_FINGER_DOWN;
}
mHasPerformedLongPress = false;
// 8. 如果不可点击,则检测是否可以长按
// 如果可以,则发送一个延迟 500 ms 的长按事件
if (!clickable) {
checkForLongClick(0, x, y);
break;
}
// 9. 检测是否触发是鼠标右键类行为,如果是则直接跳过
if (performButtonActionOnTouchDown(event)) {
break;
}
// 10. 是否在可滑动的容器中
// 该方法会递归查询每一个 viewGroup 容器是是否会支持当用户尝试滑动
// 内容时阻止pressed state的出现,该 pressed state 会被延迟反馈
boolean isInScrollingContainer = isInScrollingContainer();
if (isInScrollingContainer) {
mPrivateFlags |= PFLAG_PREPRESSED;
if (mPendingCheckForTap == null) {
mPendingCheckForTap = new CheckForTap();
}
mPendingCheckForTap.x = event.getX();
mPendingCheckForTap.y = event.getY();
postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
} else {
//设置按压状态,检测长按
setPressed(true, x, y);
checkForLongClick(0, x, y);
}
break;
// 11.处理 MotionEvent.ACTION_CANCEL 事件
// 设置非按压状态,清空tap和长按回调,重置状态
case MotionEvent.ACTION_CANCEL:
if (clickable) {
setPressed(false);
}
removeTapCallback();
removeLongPressCallback();
mInContextButtonPress = false;
mHasPerformedLongPress = false;
mIgnoreNextUpEvent = false;
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
break;
// 12. 处理 MotionEvent.ACTION_MOVE
case MotionEvent.ACTION_MOVE:
// 如果可以点击,则需要处理 Hotspot
// 这个效果是在5.0以后出现,主要是处理 RippleDrawable 的效果
if (clickable) {
drawableHotspotChanged(x, y);
}
// 如果移出了 view 的范围,则需要重置状态
if (!pointInView(x, y, mTouchSlop)) {
removeTapCallback();
removeLongPressCallback();
if ((mPrivateFlags & PFLAG_PRESSED) != 0) {
setPressed(false);
}
mPrivateFlags3 &= ~PFLAG3_FINGER_DOWN;
}
break;
}
return true;
}
return false;
}
上述代码中,有两处 callback 的逻辑你可能还没有完全明白,一个是 TapCallback,一个是 LongPressCallback,分别对应 mPendingCheckForTap
和 mPendingCheckForLongPress
,看下完整的代码。
// 代码段1,类 CheckForTap
// run 内实际上是调用 代码段5
private final class CheckForTap implements Runnable {
public float x;
public float y;
@Override
public void run() {
mPrivateFlags &= ~PFLAG_PREPRESSED;
setPressed(true, x, y);
checkForLongClick(ViewConfiguration.getTapTimeout(), x, y);
}
}
// 代码段2,延迟发送 mPendingCheckForTap
// ViewConfiguration.getTapTimeout() == 100 ms
if (mPendingCheckForTap == null) {
mPendingCheckForTap = new CheckForTap();
}
mPendingCheckForTap.x = event.getX();
mPendingCheckForTap.y = event.getY();
postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
// 代码段3,移出 mPendingCheckForTap 对象
private void removeTapCallback() {
if (mPendingCheckForTap != null) {
mPrivateFlags &= ~PFLAG_PREPRESSED;
removeCallbacks(mPendingCheckForTap);
}
}
// 代码段4,类 CheckForLongPress
// run 内会判断状态并简介调用 view.OnLongClickListener#onLongClick
private final class CheckForLongPress implements Runnable {
private int mOriginalWindowAttachCount;
private float mX;
private float mY;
private boolean mOriginalPressedState;
@Override
public void run() {
if ((mOriginalPressedState == isPressed()) && (mParent != null)
&& mOriginalWindowAttachCount == mWindowAttachCount) {
if (performLongClick(mX, mY)) {
mHasPerformedLongPress = true;
}
}
}
//...
}
// 代码段5,延迟检测发送处理长按行为
// ViewConfiguration.getLongPressTimeout() == 500 ms
private void checkForLongClick(int delayOffset, float x, float y) {
if ((mViewFlags & LONG_CLICKABLE) == LONG_CLICKABLE || (mViewFlags & TOOLTIP) == TOOLTIP) {
mHasPerformedLongPress = false;
if (mPendingCheckForLongPress == null) {
mPendingCheckForLongPress = new CheckForLongPress();
}
mPendingCheckForLongPress.setAnchor(x, y);
mPendingCheckForLongPress.rememberWindowAttachCount();
mPendingCheckForLongPress.rememberPressedState();
postDelayed(mPendingCheckForLongPress,
ViewConfiguration.getLongPressTimeout() - delayOffset);
}
}
// 代码段6,移出 mPendingCheckForTap 对象
private void removeLongPressCallback() {
if (mPendingCheckForLongPress != null) {
removeCallbacks(mPendingCheckForLongPress);
}
}
上述6个代码段用于加深理解
会调用 onTouchEvent
内事件的处理而已。从上上段代码上看,我们总结下整个流程:代码段1代码段5
,实际上也是延迟发送 “处理长按行为”。和直接调用 代码5
不同,代码5
中延迟 500-delayOffset
ms 执行 “处理长按行为”,而源码的调用基本都是默认 delayOffset = 0
。代码1 则以 delayOffset = 100
先延迟 100 ms之后延迟 400 ms 发送处理长按行为,同样需要 500 ms 才会支持 “处理长按行为”。那到底为啥要这么做呢?
原因是当前处理的 view 位于可滑动的容器内需要延迟处理接收的按压事件。这样讲有点抽象,你可以这样理解,android 把 MotionEvent.ACTION_DOWN
场景区分为 滑动(scroll)
和 轻敲(tap)
,用延迟的时间来判断手势已经发生了位移。如果发生了位移,则还依然需要保持判断有效长按时间(500 ms)不变,所以会追加 400 ms延迟来 post 一个 “处理长按行为” 任务。
- 如果
view
不可用则根据是否可点击来直接消费MotionEvent.ACTION_UP
- 如果
view
设置了mTouchDelegate
,则默认尝试消费 Touch 事件 - 如果
view
可点击或者在 tooltip 显示状态下默认消费事件,否则返回 false 给dispatchTouchEvent
。MotionEvent.ACTION_UP
分支会设置按压状态,触发点击或长按事件,最后重置状态MotionEvent.ACTION_DOWN
分支延迟发送“处理长按行为”MotionEvent.ACTION_CANCEL
分支重置处理 Touch 过程中设置的状态MotionEvent.ACTION_MOVE
分支处理滑动 RippleDrawable 效果并在手势滑出 View 范围情况下重置状态
总结: onTouchEvent
是真正完成对 Touch 事件的处理,并把处理结果作为dispatchTouchEvent
的递归结果。
5个案例加强理解
GitHub链接上有本次 Touch传递测试代码
测试案例两个 viewGroup
和 一个 view
- 场景一:
View3#onTouchEvent
返回true
消费所有事件,上层不拦截。
场景一可知:View3
消费所有事件并返回 true
,对于上层下发的任何事件,dispatchTouchEvent
都返回 true
。
- 场景二:
View3#onTouchEvent
返回false
不消费 Touch 事件,上层不拦截,Linearlayout2
返回true
消费所有 Touch 事件。
场景二可知:如果末层不消费所有事件,则 ACTION_DOWN
会开始从末层向上传递。Linearlayout2
消费了ACTION_DOWN
之后,其及上层dispatchTouchEvent
都返回 true
。ACTION_DOWN
之后的事件序列(如ACTION_MOVE,ACTION_UP)都会往Linearlayout2
分发,其下层就再也收不到后续事件了。
- 场景三:
Linearlayout2#onInterceptTouchEvent
返回true
拦截 Touch 事件,但是Linearlayout2#onTouchEvent
返回false
不消费事件。
场景三可知:Linearlayout2
拦截了 ACTION_DOWN
之后,其子 View 再也收不到任何事件,其消费结果由 onTouchEvent
决定,如果不消费,则往上层传,直到找到某层消费事件。如果没有任何一层消费,则后续事件序列也不会下发了。
- 场景四:
Linearlayout2#onInterceptTouchEvent
返回true
拦截 Touch 事件,但是Linearlayout2#onTouchEvent
返回true
消费事件。
场景四可知:Linearlayout2
拦截了 ACTION_DOWN
之后,其子 View 再也收不到任何事件,如果消费 ACTION_DOWN
,则后续事件序列都往Linearlayout2
下发。
- 场景五:
View3#onTouchEvent
返回true
消费所有除ACTION_CANCEL
事件,但是Linearlayout2#onInterceptTouchEvent
拦截了ACTION_MOVE
事件且不消费任何事件。
场景五可知:ACTION_DOWN
传递到 View3
被其消费,后续序列事件本应该传递到 View3
。当 ACTION_MOVE
被 Linearlayout2
拦截之后,无论是否消费,View3
再也收不到 ACTION_MOVE
及其后续的事件序列。但是会在事件被一次拦截时收到 ACTION_CANCEL
,是否消费 ACTION_CANCEL
的结果会被当做此次传递的结果返回,而不是执行 Linearlayout2 的 onTouchEvent 作为结果返回
。此次ACTION_MOVE
后续的事件序列往 Linearlayout2
下发,并以 Linearlayout2
的 onTouchEvent 结果返回。
2张流程图看懂没?
出处: yummyLau,原文链接(https://yummylau.com/2018/03/05/源码解析_2018-03-05_Touch事件源码解析/)