在Android系统中,当一个MotionEvent产生以后,系统需要把这个事件传递给一个具体的View,而这个传递的过程就是事件分发过程。点击事件的分发过程由三个很重要的方法来共同完成:dispatchTouchEvent、onInterceptTouchEvent、onTouchEvent。
public boolean dispatchTouchEvent(MotionEvent ev)
用来进行事件的分发。如果事件能够传递给当前的View,那么此方法一定会被调用,返回结果受当前View的onTouchEvent和下级View的dispatchTouchEvent方法的影响,表示是否消耗当前事件。
public boolean onInterceptTouchEvent(MotionEvent event)
在上述方法内部调用,用来判断是否拦截某个事件,如果当前View(ViewGroup)拦截了某个事件,那么在同一个事件序列中,此方法不会被再次调用,返回结果表示是否拦截此次事件。
public boolean onTouchEvent(MotionEvent event)
在dispatchTouchEvent方法中调用,用来处理点击事件,返回结果表示是否消费当前时间,如果不消费,则在同一个事件序列中,当前View无法再次接收到事件。
用一段伪代码来表明上述三个方法之间的关系:
public boolean dispatchTouchEvent (MotionEvent ev) {
boolean consume = false;
if (onInterceptTouchEvent(ev)) {
consume = onTouchEvent(ev);
} else {
consume = child.dispatchTouchEvent(ev);
}
return consume;
}
当一个View设置了OnTouchListener时,那么OnTouchListener中的onTouch方法就会被回调。这时,时间如何处理还要看onTouch的返回值,如果返回false,则当前View的onTouchEvent方法会被调用;如果返回的是true,那么onTouchEvent方法将不会被调用。因此,给View设置OnTouchListener,其优先级比onTouchEvent要高。在onTouchEvent方法中,如果当前设置的有OnClickListener,那么它的onClick方法会被调用。可以看处,OnClickListener的优先级最低,即处于事件传递的尾端。所以点击事件的优先级为:OnTouchListener > onTouchEvent > OnClickListener 。
public boolean dispatchTouchEvent(MotionEvent event) {
// 下面一段代码是判断是否有OnTouchListener,及onTouch回调方法.
...
if (onFilterTouchEventForSecurity(event)) {
//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;
}
结论:
当一个点击事件产生后,它的传递过程如下:Activity->Window->View(DecorView) 如果一个View的onTouchEvent返回false,那么它的父容器的onTouchEvent会被调用,以此类推,如果所有的元素都不处理这个事件,那么这个事件将最终返回给Activity处理。
正常情况下同一事件序列内的事件不能分别由两个View同时处理,但是通过特殊手段可以做到,比如一个View将本该自己处理的事件通过onTouchEvent强行传递给其他View来处理。
一个事件一旦交给一个View来处理,那么它就必须消费掉,否则同一事件序列中剩下的事件就不再交给它来处理了。
如果一个View只消费了ACTION_DOWN事件,即使它不消费其他事件,那么其父控件也不会走onTouchEvent方法,并且当前View可以持续接收到后续的事件,最终这些消失的点击事件会传递给Activity处理。
ViewGroup的onInterceptTouchEvent方法默认为false。View的onTouchEvent方法默认为true。也就是说View默认会消费点击事件,除非它不可点击(clickable 和 longClickable 同时为false ),View的 longClickable属性默认就是false,clickable属性要分情况,比如Button的clickable属性默认为true,而TextView的clickable默认为false。
View的enable属性不影响onTouchEvent的默认返回值。哪怕一个View是disable状态的,只要它的clickable或者longClickable有一个true。那么它的onTouchEvent就返回true。
事件传递的过程是由外向内的,即事件总是先传递给父元素,然后再由父元素分发给子View,通过requestDisallowInterceptTouchEvent方法可以在子元素中干预父元素的事件分发过程,但是ACTION_DOWN除外。
用于辅助检测用户的单击、滑动、长按、双击等行为,使用时调用的是GestureDetector。
GestureDetecotor mGestureDetector = new GestureDetector(this);
mGestureDetector.setIsLongpressEnabled(false);
接着接管View的onTouchEvent方法,在onTouchEvent方法中执行:
boolean consume = mGestureDetector.onTouchEvent(event);
return consume;
执行完上面两步,就可以有选择的实现OnGestureListener和OnDoubleTapListener中的方法了;
OnGestureListener接口的方法:onDown触摸屏幕的瞬间,由一个ACTION_DOWN触发;onShowPress,触摸屏幕没有松开,由一个ACTION_DOWN触发;onSingleTapUp,单击行为,伴随着一个ACTION_UP触发;onScroll,按下屏幕拖动,由一个ACTION_DOWN和多个ACTION_MOVE触发;onLongPress,长按;onFling,按下屏幕快速滑动后松开,由一个ACTION_DOWN,多个ACTION_MOVE和一个ACTION_UP触发;
OnDoubleTapListener接口的方法:onSingleTapConfirmed,严格的单击行为,只可能是单击而不可能是双击中的单击,这点同onSingleTapUp方法是有区别的;onDoubleTapEvent,双击行为;
作者建议:如果只是监听滑动相关的,建议自己在onTouchEvent方法中实现,如果是要监听双击这种行为,就使用GestureDetector。
事件最先传递给当前Activity,由Activity的dispatchTouchEvent来进行事件派发,具体的工作是由Activity内部的Window来完成的。Window会将事件传递给decor view(setContentView的父容器),通过Activity.getWindow().getDecorView()可以获得。
源码:Activity#dispatchTouchEvent
public boolean dispatchTouchEvent(MotionEvent ev) {
if (ev.getAction() == MotionEvent.ACTION_DOWN) {
onUserInteraction();
}
if (getWindow().superDispatchTouchEvent(ev)) {
return true;
}
return onTouchEvent(ev);
}
首先事件交给Activity附属的Window进行分发,如果返回true,整个事件循环就结束了,返回false意味着事件没有被消费,也就是所有的View的onTouchEvent都返回了false,那么Activity的onTouchEvent就会被调用。
这里面Window是抽象类,唯一实现类是PhoneWindow(位于android.policy包)
源码:PhoneWindow#superDispatchTouchEvent
public boolean superDispatchTouchEvent (MotionEvent event) {
return mDecor.superDispatchTouchEvent(event);
}
因为DevorView继承自FrameLayout,且是父View,也就是会将事件继续向下传递。
源码: ViewGroup#dispatchTouchEvent
// 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();
}
// Check for interception.
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;
}
从代码中看出ViewGroup在如下两种情况下回判断是否要拦截当前事件:事件类型为ACTION_DOWN或者mFirstTouchTarget != null时。从后面的代码中可以看出,如果子元素消费事件,那么mFirstTouchTarget会被赋值并且指向子元素。
上文代码中有个标记位FLAG_DISALLOW_INTERCEPT,这个标记位是通过requestDisallowInterceptTouchEvent方法来设置的,一般用于子View中。当这个标记位被设置后,ViewGroup将无法拦截除了ACTION_DOWN以外的其他事件。如果是ACTION_DOWN就会重置FLAG_DISALLOW_INTERCEPT这个标记位,将导致这个标记位无效(会调用resetTouchState方法来进行重置标记位)。所以DOWN事件开始时,ViewGroup总会询问一下onIntercept方法是否需要拦截事件。
总结:
(1)onInterceptTouchEvent不是每次事件都会被调用的,如果想提前处理所有的事件,要选择dispatchTouchEvent方法。
(2)当面对滑动冲突时,可以考虑用requestDisalllowTouchEvent来处理。
mFirstTouchTarget的赋值是在addTouchTarget方法中来完成的。
源码: ViewGroup#addTouchTarget
private TouchTarget addTouchTarget(View child, int pointerIdBits) {
TouchTarget target = TouchTarget.obtain(child, pointerIdBits);
target.next = mFirstTouchTarget;
mFirstTouchTarget = target;
return target;
}
mFristTouchTarget是一种单链表结构,是否被赋值将直接影响到ViewGroup对事件的拦截策略。
源码: View#dispatchTouchEvent
public boolean dispatchTouchEvent(MotionEvent event) {
...
if (onFilterTouchEventForSecurity(event)) {
//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不包含子元素所以自己处理就可以,首先会判断是否设置了OnTouchListener,如果OnTouchListener的onTouch方法返回的是true,那么onTouchEvent就不会被调用。所以OnTouchListener的优先级更高。
分析onTouchEvent的实现,当View处于不可用状态下点击事件的处理过程,如下所示,很明显,不可用状态下的View依然会消耗点击事件,尽管看起来不可用。
源码: View#onTouchEvent
if ((viewFlags & ENABLED_MASK) == DISABLED) {
if (action == MotionEvent.ACTION_UP && (mPrivateFlags & PFLAG_PRESSED) != 0) {
setPressed(false);
}
// A disabled view that is clickable still consumes the touch
// events, it just doesn't respond to them.
return (((viewFlags & CLICKABLE) == CLICKABLE
|| (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
|| (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE);
}
如果View设置了代理,那么还会执行TouchDelegate的onTouchEvent方法,它的工作机制同OnTouchuListener类似,这是作为增加View的触摸范围的方法,需要设置代理对象,可以同padding一同使用。
if (mTouchDelegate != null) {
if (mTouchDelegate.onTouchEvent(event)) {
return true;
}
}
onTouchEvent方法的具体处理
if (((viewFlags & CLICKABLE) == CLICKABLE ||
(viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) ||
(viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE) {
switch (action) {
case MotionEvent.ACTION_UP:
boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
// take focus if we don't have it already and we should in
// touch mode.
boolean focusTaken = false;
if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
focusTaken = requestFocus();
}
if (prepressed) {
// The button is being released before we actually
// showed it as pressed. Make it show the pressed
// state now (before scheduling the click) to ensure
// the user sees it.
setPressed(true, x, y);
}
if (!mHasPerformedLongPress && !mIgnoreNextUpEvent) {
// This is a tap, so remove the longpress check
removeLongPressCallback();
// Only perform take click actions if we were in the pressed state
if (!focusTaken) {
// Use a Runnable and post this rather than calling
// performClick directly. This lets other visual state
// of the view update before click actions start.
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)) {
// If the post failed, unpress right now
mUnsetPressedState.run();
}
removeTapCallback();
}
mIgnoreNextUpEvent = false;
break;
case MotionEvent.ACTION_DOWN:
mHasPerformedLongPress = false;
if (performButtonActionOnTouchDown(event)) {
break;
}
// Walk up the hierarchy to determine if we're inside a scrolling container.
boolean isInScrollingContainer = isInScrollingContainer();
// For views inside a scrolling container, delay the pressed feedback for
// a short period in case this is a scroll.
if (isInScrollingContainer) {
mPrivateFlags |= PFLAG_PREPRESSED;
if (mPendingCheckForTap == null) {
mPendingCheckForTap = new CheckForTap();
}
mPendingCheckForTap.x = event.getX();
mPendingCheckForTap.y = event.getY();
postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
} else {
// Not inside a scrolling container, so show the feedback right away
setPressed(true, x, y);
checkForLongClick(0);
}
break;
case MotionEvent.ACTION_CANCEL:
setPressed(false);
removeTapCallback();
removeLongPressCallback();
mInContextButtonPress = false;
mHasPerformedLongPress = false;
mIgnoreNextUpEvent = false;
break;
case MotionEvent.ACTION_MOVE:
drawableHotspotChanged(x, y);
// Be lenient about moving outside of buttons
if (!pointInView(x, y, mTouchSlop)) {
// Outside button
removeTapCallback();
if ((mPrivateFlags & PFLAG_PRESSED) != 0) {
// Remove any future long press/tap checks
removeLongPressCallback();
setPressed(false);
}
}
break;
}
return true;
}
从上面代码来看,只要View的CLICKABLE和LONG_CLICKABLE有一个为true,就会消耗当前事件,即onTouchEvent返回为true,不管是不是DISABLE状态。
在ACTION_UP事件发生时,会触发performClick方法,如果View设置了OnClickListener,那么performClick方法会调用它的onClick方法。
源码: View#performClick
public boolean performClick() {
final boolean result;
final ListenerInfo li = mListenerInfo;
if (li != null && li.mOnClickListener != null) {
playSoundEffect(SoundEffectConstants.CLICK);
li.mOnClickListener.onClick(this);
result = true;
} else {
result = false;
}
sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
return result;
}
View中,LONG_CLICKABLE默认为false,而可点击的View中CLICKABLE默认为true,不可点击的默认为false。而给View设置OnClickListener和OnLongClickListener会默认给对应的属性设置为true。