ViewGroup的OnInterceptTouchEvent方法的调用特点
- 当ViewGroup的childView的onTouchEvent方法返回true时表示该childView可以接受MotionEvent事件, 此时在ViewGroup上的有MotionEvent时间发生时,每次都会调用OnInterceptTouchEvent方法。
当ViewGroup的childView的onTouchEvent方法返回false时表示该childView不接受MotionEvent事件, 如果ViewGroup的onTouchEvent方法返回true表示ViewGroup可以接受MotionEvent方法,此后onInterceptTouchEvent方法不会再调用,直接调用ViewGroup 的onTouchEvent方法。
一个MotionEvent事件由一个ACTION_DOWN事件,若干个ACTION_MOVE事件,一个ACTION_UP事件组成。当一个MotionEvent事件发生时,ViewGroup接到MotionEvent的上述的事件后,ViewGroup调用自己的dispatchTouchEvent方法来向其childView以及自身来分配MotionEvent的事件。来看ViewGroup的dispatchTouchEvent方法:
public boolean dispatchTouchEvent(MotionEvent ev) {
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(ev, 1);
}
boolean handled = false;
if (onFilterTouchEventForSecurity(ev)) {
final int action = ev.getAction();
final int actionMasked = action & MotionEvent.ACTION_MASK;
// Handle an initial down.
/**ACTION_DOWN表示新的事件到来,取消并且清楚之前保留的TouchTarget,并且重置touchState,
*TouchTarget表示接受MotionEvent的childView。
**/
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();
}
// Check for interception.
final boolean intercepted;
/*
*下面的判断表示当ACTION_DOWN事件到来时,需要调用OnInterceptTouchEvent方法。同时如果 *mFirstTouchTarget不为null时需要调用OnInterceptTouchEvent方法,mFirstTouchTarget不为null
*表示childView可以接受MotionEvent事件,即childView中有onTouchEvent返回true的。当ACTION_DOWN事
*件到来时,mFirstTouchEvent必然为null。当MotionEvent后面的ACTION_MOVE和ACTION_UP事件到来时,
*mFirstTouchTarget为null(childView都不接受MotionEvent事件),就会进入else语句,不会再调用
*onInterceptTouchEvent方法。
*/
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {
//disallowIntercept可以让childView通过调用requestDisallowInterceptTouchEvent方法来设置
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;
// Update list of touch targets for pointer down, if needed.
final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
TouchTarget newTouchTarget = null;
boolean alreadyDispatchedToNewTouchTarget = false;
/*
*当上面的intercepted为false,并且canceled为false时,就要向childview传递MotionEvent事件了。
*
*当ACTION_DOWN事件到来时,再上面调用了onInterceptTouchEvent方法,该方法默认返回false,当该方法
*返回false,即intercepted为false(resetCancelNextUpFlag(this)大多情况下放回false,所以
*canceled肯定为false,因为是ACTION_DOWN),if语句满足。
*/
if (!canceled && !intercepted) {
/*
*当ACTION_DOWN或者ACTION_MOVE或者ACTION_POINTER_DOWN同时ViewGroup可以讲一个事件分给多个
*childView时,进入if语句。
*/
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);
/*
*下面找出MotionEvent对应的那个childView
*/
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 = buildOrderedChildList();
final boolean customOrder = preorderedList == null
&& isChildrenDrawingOrderEnabled();
final View[] children = mChildren;
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);
/*
*当该childView不是可见,或者childView的区域不包含MotionEvent的位置,则继续遍历
*/
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
continue;
}
//获取该childView对应的touchTarget
newTouchTarget = getTouchTarget(child);
//在ACTION_DOWN阶段,newTouchTarget肯定为null,这里在ACTION_POINTER_DOWN阶段进入if条件
if (newTouchTarget != null) {
// Child is already receiving touch within its bounds.
// Give it the new pointer in addition to the ones it is handling.
newTouchTarget.pointerIdBits |= idBitsToAssign;
break;
}
resetCancelNextUpFlag(child);
/*
*dispatchTransformedTouchEvent方法中会调用child的dispatchTouchEvent方法。
*如果child不是ViewGroup,则child的dispatchTouchEvent调用了OnTouchListener
*的onTouch方法,如果onTouch返回false,调用onTouchEvent方法。
*如果dispatchTransformedTouchEven返回true,说明child接受Touch事件。
*/
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();
/*
*调用addTouchTarget后,mFirstTouchTarget就不为null了。
*/
newTouchTarget = addTouchTarget(child, idBitsToAssign);
alreadyDispatchedToNewTouchTarget = true;
break;
}
}
if (preorderedList != null) preorderedList.clear();
}
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;
}
}
}
/*
*没有child可以接受MotionEvent, 让自己来。
*/
// 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语句表示在ACTION_DOWN阶段已经处理过了就不再处理
if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
handled = true;
} else {
/*
*下面将ACTION_MOVE事件和ACTION_UP事件对之前接受ACTION_DOWN事件的childView进行传递。
*/
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;
}
}
// Update list of touch targets for pointer up or cancel, if needed.
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;
}