View事件分发
解决已有问题是成功的捷径之一
1.一些常见问题
onTouch和onTouchEvent有什么区别?
为什么有时候onTouch中不返回true,也可以执行到MOVE、UP事件?
onTouch和onTouchEvent和onClick哪个先执行?
一些可滚动的控件嵌套时的怎么不能滚动了?
看源码是解决问题的捷径,么有之一
2.深入
平常使用中,常见的一个删除按钮,想加上onClick点击事件,使用方式如下:
deleteButton.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
LoggerUtil.e("onClick");
}
});
当按钮被点击时,会执行onClick中的代码,打印"onClick"。
view的onTouch方法使用方式类似:
deleteButton.setOnTouchListener(new OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
return false;
}
});
当手指在这个view上面按下、移动、抬起时都会执行onTouch中的代码,这里我没有打印log,方便大家观察这个方法和onClick方法的不同,有两个不同点:1、入参比onClick多了一个MotionEvent(动作事件),2、返回参数是boolean类型,现在在onTouch中加上log并且把多的一个参数打印出来。
deleteButton.setOnTouchListener(new OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
LoggerUtil.e("onTouch action = "+event.getAction());
return false;
}
});
现在两个事件都注册了,我们来点击一下这个view,打印结果如下:
onTouch action = 0
onTouch action = 2(省略多条)
onTouch action = 1
onClick
可以看到,先执行了onTouch再执行了onClick,并且onTouch执行了很多次。
暂时得出结论:事件传递顺序是经过onTouch,再传递到onClick。
我们来看一下刚才说的第一个不同点:MotionEvent源码中看到0是ACTION_DOWN,2是ACTION_MOVE,1是ACTION_UP,说明我在点的过程中手指移动了一下。
第二个不同点:可以看到默认返回参数是false,现在改为true再运行一次,结果如下
onTouch action = 0
onTouch action = 1
这一次我们发现onTouch action = 2没有打印,onClick也没有打印,onTouch action = 2没有打印时因为我这次没有手抖,onClick为什么也没有打印呢?
看一下onTouch源码中对返回参数的注释
/**
* Called when a touch event is dispatched to a view. This allows listeners to
* get a chance to respond before the target view.
*
* @param v The view the touch event has been dispatched to.
* @param event The MotionEvent object containing full information about
* the event.
* @return True if the listener has consumed the event, false otherwise.
*/
boolean onTouch(View v, MotionEvent event);
如果这个listener消耗了这个event(事件),就返回true,否则返回false。
我们可以完善刚才得出的结论:事件传递顺序是经过onTouch,再传递到onClick,如果事件被onTouch消耗了,那么就不会继续传递给onClick。
继续深入源码,看看为什么事件被消耗就不会传递给onClick。
所有事物都有源头。
我们先记住一点:事件传递的源头是dispatchTouchEvent方法,只要你触摸了控件,就一定会调用这个方法。
当我们点击这个删除按钮时,会调用Button类里的dispatchTouchEvent,打开Button源码,没有dispatchTouchEvent,去父类TextView中找,还是么有,继续去父类View中找,OK,找到了,再找不到就不可能了,因为View并没有形式上的父类了。来看一下dispatchTouchEvent源码
/**
* Pass the touch screen motion event down to the target view, or this
* view if it is the target.
*
* @param event The motion event to be dispatched.
* @return True if the event was handled by the view, false otherwise.
*/
public boolean dispatchTouchEvent(MotionEvent event) {
// If the event should be handled by accessibility focus first.
if (event.isTargetAccessibilityFocus()) {
// We don't have focus or no virtual descendant has it, do not handle the event.
if (!isAccessibilityFocusedViewOrHost()) {
return false;
}
// We have focus and got the event, then use normal event dispatch.
event.setTargetAccessibilityFocus(false);
}
boolean result = false;
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(event, 0);
}
final int actionMasked = event.getActionMasked();
if (actionMasked == MotionEvent.ACTION_DOWN) {
// Defensive cleanup for new gesture
stopNestedScroll();
}
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;
}
}
if (!result && mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);
}
// Clean up after nested scrolls if this is the end of a gesture;
// also cancel it if we tried an ACTION_DOWN but we didn't want the rest
// of the gesture.
if (actionMasked == MotionEvent.ACTION_UP ||
actionMasked == MotionEvent.ACTION_CANCEL ||
(actionMasked == MotionEvent.ACTION_DOWN && !result)) {
stopNestedScroll();
}
return result;
}
首先看一下注释,这个方法是用来传递一个动作事件给目标view,如果目标view就是当前view时,则传递给它寄几。
返回结果:如果事件被目标view处理返回true,否则返回false
然后让我们找到返回true的代码:
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;
}
}
onFilterTouchEventForSecurity方法先过滤掉view被遮蔽的情况,然后
(mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)
判断view状态是否是enable(默认都是enable)并且event是否是滚动条在拖动,如果是返回true。
如果不是的话,继续执行
li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
&& li.mOnTouchListener.onTouch(this, event))
首先判断mOnTouchListener是否为空,这个一定不为空,因为setOnTouchListener方法中做了赋值操作。
然后判断view状态是否是enable。
(注意,这是onTouch能执行的前置条件,onTouchEvent不会受这个条件制约,所以如果想对一个非enable的控件做事件处理,除了把状态变为enable,还可以重写onTouchEvent方法。)
最后判断onTouch的返回值,刚才我们看了onTouch源码的注释:如果listener消耗了这个事件就返回true,否则返回false。
我们注意到,这里执行了onTouch方法。
当上面返回true的时候就不会执行下面的方法了,因为下面方法的条件是要上面结果为false:
if (!result && onTouchEvent(event)) {
result = true;
}
当上面返回false,并且onTouchEvent返回true,则dispatchTouchEvent结果为true。
我们注意到,这里执行了onTouchEvent。
这里可以得到一个结论:当onTouch返回true时,就不会执行onTouchEvent,否则就会执行onTouchEvent。
刚才我们一直在分析onTouch和onClick,这里又冒出来一个onTouchEvent是干什么的呢?onClick是否在onTouchEvent方法中呢?
继续深入onTouchEvent源码。
还是先看下方法注释:
/**
* Implement this method to handle touch screen motion events.
* <p>
* If this method is used to detect click actions, it is recommended that
* the actions be performed by implementing and calling
* {@link #performClick()}. This will ensure consistent system behavior,
* including:
* <ul>
* <li>obeying click sound preferences
* <li>dispatching OnClickListener calls
* <li>handling {@link AccessibilityNodeInfo#ACTION_CLICK ACTION_CLICK} when
* accessibility features are enabled
* </ul>
*
* @param event The motion event.
* @return True if the event was handled, false otherwise.
*/
public boolean onTouchEvent(MotionEvent event)
这个方法用来处理触摸屏幕的动作事件。
我们也知道onTouch方法是:当一个触摸事件被发送给一个view时会调用onTouch方法,这样可以让listener在目标view之前响应。
对比一下可以看出onTouchEvent是对各种action做了处理,而onTouch没有。
public boolean onTouchEvent(MotionEvent event) {
final float x = event.getX();
final float y = event.getY();
final int viewFlags = mViewFlags;
final int action = event.getAction();
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);
}
if (mTouchDelegate != null) {
if (mTouchDelegate.onTouchEvent(event)) {
return true;
}
}
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, x, y);
}
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;
}
return false;
}
大致可以看出这个方法内部主要在处理MotionEvent的各种状态,什么条件下开始处理呢,当满足条件:
if (((viewFlags & CLICKABLE) == CLICKABLE ||
(viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) ||
(viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE)
也就是说,当view是可以点击的就可以进入到处理动作事件的代码块中,并且onTouchEvent方法返回true。
在case MotionEvent.ACTION_UP中的performClick()中可以找到onClick方法:
/**
* Call this view's OnClickListener, if it is defined. Performs all normal
* actions associated with clicking: reporting accessibility event, playing
* a sound, etc.
*
* @return True there was an assigned OnClickListener that was called, false
* otherwise is returned.
*/
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;
}
可以看到,只要mOnClickListener不是null,就会去调用它的onClick方法,mOnClickListener的赋值就在setOnClickListener当中。
结合上面所有结论,得出:事件传递顺序是先传递给onTouch,如果事件没有被onTouch消耗,会传递给onTouchEvent,当View是可点击的状态,抬起手指的事件中会执行onClick。
onTouch,onTouchEvent,onClick之间的流程顺序我们清楚了,那么回头看最上面的例子,为什么onClick打印一次,onTouch被打印了多次呢?
这里有一个知识点就是:
touch事件的层级传递。我们都知道如果给一个控件注册了touch事件,每次点击它的时候都会触发一系列的ACTION_DOWN,ACTION_MOVE,ACTION_UP等事件。当执行ACTION_DOWN的时候返回false,后续的action都不会再执行。
可以理解为接力跑步,当前一个运动员把接力棒交给下一个运动员手里时,下一个运动员才可以开始跑步;当前一个action返回true时,下一个action才被触发。
这里又有问题了!一开始的例子中,onTouch返回的是false,为什么还可以打印很多次?不是应该只打印一次吗?
当然不是,经过刚才的结论我们已经可以解释这个现象:
首先执行onTouch,这时onTouch返回的是false,表示事件没有被onTouch消耗,继续传递给onTouchEvent,又因为button是默认可点击的,所以继续执行了后续的action。
可以尝试下把Button换成ImageView,只注册touch监听,并返回false,只会打印onTouch action = 0,因为ImageView默认不可点击。(如果返回true,各种action就都可以打印出来了)
问题又来了!如果你的ImageView注册touch监听,并返回false,同时注册了click监听,你会发现所有的action都打印了,并且onClick也打印了!说好的ImageView默认不可点击只会打印action = 0呢???
答案在setOnClickListener方法中,没错就是设置click监听的那个方法,看源码:
public void setOnClickListener(@Nullable OnClickListener l) {
if (!isClickable()) {
setClickable(true);
}
getListenerInfo().mOnClickListener = l;
}
这里不仅给mOnClickListener赋值,还做了一个操作:当view不可点击时,设置为可点击。
破案了。
3.浅出
来回顾下一开始的问题
onTouch和onTouchEvent有什么区别?
onTouch和onTouchEvent都是在dispatchTouchEvent中执行,onTouch优先于onTouchEvent执行。如果onTouch中通过返回true把事件消费掉,则onTouchEvent不会执行。(可以把刚才同时注册onTouch和onClick的ImageView的onTouch返回改为true,onClick就不会打印了,因为onClick是在onTouchEvent中调用的)
为什么有时候onTouch中不返回true,也可以执行到MOVE、UP事件?
因为onTouch返回false的时候dispatchTouchEvent会调用onTouchEvent方法,如果view是可点击的状态,就会执行各种action。