了解更多,移步Android触摸事件传递机制系列详解
通过Android触摸事件的传递(七)-ViewGroup可以看到ViewGroup或子view自身真正处理事件时都是通过View的dispatchTouchEvent分发下去的。
1. View的dispatchTouchEvent
/**
* Pass the touch screen motion event down to the target view, or this
* view if it is the target.
* 将屏幕的按压事件传递给目标view,或者当前view即目标view
* @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) {
//最前面这一段就是判断当前事件是否能获得焦点,
// 如果不能获得焦点或者不存在一个View,那我们就直接返回False跳出循环
// 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);
}
//Android用一个32位的整型值表示一次TouchEvent事件,低8位表示touch事件的具体动作,比如按下,抬起,滑动,还有多点触控时的按下,抬起,这个和单点是区分开的,下面看具体的方法:
//1 getAction:触摸动作的原始32位信息,包括事件的动作,触控点信息
//2 getActionMasked:触摸的动作,按下,抬起,滑动,多点按下,多点抬起
//3 getActionIndex:触控点信息
final int actionMasked = event.getActionMasked();
if (actionMasked == MotionEvent.ACTION_DOWN) {
//当我们手指按到View上时,其他的依赖滑动都要先停下
// Defensive cleanup for new gesture
stopNestedScroll();
}
//过滤掉一些不合法的事件,比如当前的View的窗口被遮挡了。
if (onFilterTouchEventForSecurity(event)) {
//ListenerInfo 是view的一个内部类 里面有各种各样的listener,
// 例如OnClickListener,OnLongClickListener,OnTouchListener等等
ListenerInfo li = mListenerInfo;
//首先判断如果监听li对象!=null 且我们通过setOnTouchListener设置了监听,
// 即是否有实现OnTouchListener,
// 如果有实现就判断当前的view状态是不是ENABLED,
// 如果实现的OnTouchListener的onTouch中返回true,并处理事件,则
if (li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
&& li.mOnTouchListener.onTouch(this, event)) {
//如果满足这些条件那么返回true,这个事件就在此处理意味着这个View需要事件分发
result = true;
}
//如果上一段判断的条件没有满足(没有在代码里面setOnTouchListener的话),
// 就判断View自身的onTouchEvent方法有没有处理,没有处理最后返回false,处理了返回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;
}
粗糙浅析
//首先判断如果监听li对象!=null 且我们通过setOnTouchListener设置了监听,
// 即是否有实现OnTouchListener,
// 如果有实现就判断当前的view状态是不是ENABLED,
// 如果实现的OnTouchListener的onTouch中返回true,并处理事件,则
if (li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
&& li.mOnTouchListener.onTouch(this, event)) {
//如果满足这些条件那么返回true,这个事件就在此处理意味着这个View需要事件分发
result = true;
}
//如果上一段判断的条件没有满足(没有在代码里面setOnTouchListener的话),
// 就判断View自身的onTouchEvent方法有没有处理,没有处理最后返回false,处理了返回true;
//也就是前面的判断优先级更高
if (!result && onTouchEvent(event)) {
result = true;
}
- 如果
view
为DISENABLED
,则不会执行:li.mOnTouchListener.onTouch(this, event)
, -
mOnTouchListener
优先于mViewFlags
优先于mOnTouchListener.onTouch
优先于onTouchEvent
因为&&
2 View的onTouchEvent(event)
2.1 onTouchEvent代码
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.
//这里需要特别注意,经过view disable,但是仍旧消耗事件
return (((viewFlags & CLICKABLE) == CLICKABLE
|| (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
|| (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE);
}
//如果一个view过小,不容易点击,通过扩大点击区域实现更好的交互。可以暂且叫为代理,代理处理该事件。
//一般不怎么用到,所以可以忽略
if (mTouchDelegate != null) {
if (mTouchDelegate.onTouchEvent(event)) {
return true;
}
}
//查看view是否enable
//其实像FrameLayout RelativeLayout 是没有设置CLICKABLE, 在我们setOnclickListener之后才设置成CLICKABLE
//CONTEXT_CLICKABLE 将会响应主触笔按下或鼠标右键单击这类的事件
if (((viewFlags & CLICKABLE) == CLICKABLE ||
(viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) ||
(viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE) {
switch (action) {
case MotionEvent.ACTION_UP:
//理解这个判断,最好先看 ACTION_DOW
//指的是,如果view包裹在一个scrolling View中,可能会进行滑动处理,所以设置了一个prePress的状态
//大致是等待一定时间,然后没有被父类拦截了事件,则认为是点击到了当前的view,从而显示点击态
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;
//表示如果view是可以focus的,并且当前没有获得focus,则去申请获取focus
if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
focusTaken = requestFocus();
}
//设置点击态
//问:难道你们就没有疑问,为什么要在UP的时候才设置点击态,UP不是应该取消点击态才对吗?
//这个这是的前提是用户ACTION_DOWN在100ms(TAP_TIME)内UP了,才会到达这里
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
//取消LongPress的检测
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) {
////执行点击,回调onClickListener的onClick,也就是我们经常使用的setOnClickListener中的操作
mPerformClick = new PerformClick();
}
if (!post(mPerformClick)) {
performClick();
}
}
}
if (mUnsetPressedState == null) {
//一个runnable,用于取消press状态
mUnsetPressedState = new UnsetPressedState();
}
//取消prePress引起的setPres
if (prepressed) {
postDelayed(mUnsetPressedState,
ViewConfiguration.getPressedStateDuration());
} else if (!post(mUnsetPressedState)) {
// If the post failed, unpress right now
mUnsetPressedState.run();
}
removeTapCallback();
}
mIgnoreNextUpEvent = false;
break;
//记录点击位置,并执行是否为LongPress的检测
case MotionEvent.ACTION_DOWN:
mHasPerformedLongPress = false;
//表示是否为鼠标右键操作,可以忽略,很少用到
if (performButtonActionOnTouchDown(event)) {
break;
}
// Walk up the hierarchy to determine if we're inside a scrolling container.
//查看是否在一个scrolling view内
boolean isInScrollingContainer = isInScrollingContainer();
// For views inside a scrolling container, delay the pressed feedback for
// a short period in case this is a scroll.
//这里解释下几个状态分别是PFLAG_PREPRESSED、TAP_TIMEOUT、LONG_PRESS_TIME
//时间分别是 未知(比TAP时间短)、100ms、500ms
//0~100ms:prePress; 100~500:click状态; 500ms~:longClick
//PFLAG_PREPRESSED: 表示view在srcolling view内,如果不超过这个时间,都没有点击态
//TAP_TIMEOUT 表示,超过这个事件将算为点击
//LONG_PRESS_TIME 表示超过这时间就执行LongClick操作
//如果是在一个scrolling view内
if (isInScrollingContainer) {
mPrivateFlags |= PFLAG_PREPRESSED;
if (mPendingCheckForTap == null) {
//检测是点击还是长点击
mPendingCheckForTap = new CheckForTap();
}
mPendingCheckForTap.x = event.getX();
mPendingCheckForTap.y = event.getY();
//执行检测操作,延迟100ms
postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
} else {
// Not inside a scrolling container, so show the feedback right away
//如果不在scrolling View中,则立马设为点击态
setPressed(true, x, y);
checkForLongClick(0);
}
break;
//将所有的状态设置为最初始
case MotionEvent.ACTION_CANCEL:
setPressed(false);
removeTapCallback();
removeLongPressCallback();
mInContextButtonPress = false;
mHasPerformedLongPress = false;
mIgnoreNextUpEvent = false;
break;
//ACTION_MOVE动作下,仅仅做了将具体的坐标传递给背景以及判断点击区域是否还在view中
case MotionEvent.ACTION_MOVE:
//将实时位置传递给背景(前景)图片(Drawable)
drawableHotspotChanged(x, y);
// Be lenient about moving outside of buttons
//执行检测是否在当前的view中
//自定义view的过程中,通常没做这个操作,造成手离开了view,点击态还存在
if (!pointInView(x, y, mTouchSlop)) {
// Outside button
//离开的view,则取消检测等操作
removeTapCallback();
if ((mPrivateFlags & PFLAG_PRESSED) != 0) {
// Remove any future long press/tap checks
removeLongPressCallback();
setPressed(false);
}
}
break;
}
return true;
}
return false;
}
2.2 View点击状态判断
当我们对View进行一个点击,可以分为以下三个状态
1、
PrePress
(姑且叫为预按),这个状态是我们的view
被加入到一个scrolling view
中才会存在。具体的意义是,举个简单的例子,当我们将手放在listView
的一item
上的时候,由于当前还不知道用户是要点击item
还是想滑动listview
,所以先将view
设为PrePress
状态;2、
Press状态
,用户将手放到view
上面,如果不是1(上述)的状态,就里面设置为Press
状态。那么先进入了PrePress
,那么将会触发一个检测,也即CheckForTap()
,默认时间是100ms,如果超过了100ms,将由PrePress
进入到Press
状态;-
3、
LongPress状态
,这个状态由Press状态过度过来,如果用户在一个view上停留超过一定的时间(默认为500ms),将进入该状态。
2.3 onTouchEvent主要功能
- Step 1: 判断
View
是否为Enable
,如果为disable
将return
是否是clickable
、longClickable
、或Context_Clickable
(这个做作用于鼠标右键的操作)——说明,尽管view
是disable
的,但是依旧消耗事件,只不过不会做任何的操作。 - Step 2: 判断是否设置了相应的辅助代理,如果有,直接将事件交于它处理——这个代理的作用是在
view
比较小的情况下,用户不好点击,认为将触发区域变大的。 - Step 3: 在view可
clickable
、longClickable
、或Context_Clickable
的请下,使用switch
处理Down
、Move
、Up
、Cancel
的事件。为了方便理解,最好顺着事件的流程查看源码,流程为Down
、Move
、Up
、Cancel
(Up
和Cancel
不分先后,两者最多只能接受一个)
Down: 并触发
LongPress
的检测(设置的LongClickListner
将会时间达到的之后,进行回调)以及将状态设置为PressMove: 将x,y传递给View的
BackGround
(或ForeGround
),判断当前是否滑动离开的当前的View
的范围,如果是将Presss
设置为false
Cancel: 将状态设为初始的状态
Up: 判断是否处理了
LongPress
事件,如果处理了将返回;接下来将直线click
的操作,执行preformClick
,这个里面首先执行外接设置的onClickListener.onClick
回调;最后将Press
状态变为false
。
2.4 小结
- 在
onTouchEvent
的
MotionEvent.ACTION_UP
中会判断是否执行PerformClick
。因此onTouchEvent
的优先于PerformClick
。 -
DISABLED
下view
任然可能消费事件,CLICKABLE
、LONG_CLICKABLE
、CONTEXT_CLICKABLE
。
如button
的Clickable
为true
,而textview
的Clickable
为false
。 - onclick会发生的前提是当前view可点击—即收到up和down的事件(必要不充分)。
参考
Android中view的dispatchTouchEvent方法源码分析
原
Android事件处理(三)——View的onTouchEvent 函数源码详解