Android事件处理（三）——View的onTouchEvent 函数源码详解

作者: 林子木

博客地址：http://blog.csdn.NET/wolinxuebin

文章意图：

主要是想一自己阅读代码后的一些小收获分享给大家。让大家更加深入的了解Android的事件分发这块的内容。

文章主要内容：

本文将在第一章通过自己的语言，简单介绍view的onTouchEvent函数，并将其中的一些关键点直接提炼出来，方便那些不想阅读源代码的同学把握住其中的关键点。
在第二章将放上源码，其中包含了我阅读过程中的23处注释。
相关文章阅读为：
Android事件处理（一）——ViewGroup的dispatchTouchEvent 函数源码详解
Android事件处理（二）——View的dispatchTouchEvent 函数源码详解

第一章、View的onTouchEvent函数关键点提炼

在介绍之前，我们来了解下当我们对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），将进入该状态。



图 1 点击事件的三个状态的示意图
通过图1，我们也可以很清楚的了解到这三个状态的区别。接下来我们将分析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不分先后，两者最多只能接受一个）

1、Down:  并触发LongPress的检测(设置的LongClickListner将会时间达到的之后，进行回调)以及将状态设置为Press

2、Move:  将x,y传递给View的
BackGround (或ForeGround)，判断当前是否滑动离开的当前的View的范围，如果是将Presss设置为false

3、Cancel: 
将状态设为初始的状态

4、Up: 
判断是否处理了LongPress事件，如果处理了将返回；接下来将直线click的操作，执行preformClick，这个里面首先执行外接设置的onClickListener.onClick回调；最后将Press状态变为false。

第二章、View的 onTouchEvent 源码及分析

为了方便理解，最好顺着事件的流程查看源码，流程为Down、Move、Up、Cancel（Up和Cancel不分先后，两者最多只能接受一个）,具体带注释的源码如下：

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) {
//[lxb #1] 主要是清理点击态
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.
//[lxb #2] 这里需要特别注意，经过view disable，但是仍旧消耗事件
return (((viewFlags & CLICKABLE) == CLICKABLE
|| (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
|| (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE);
}

//[lxb #3] 如果一个view过小，不容易点击，通过扩大点击区域实现更好的交互。可以暂且叫为代理，代理处理该事件。
//[lxb #3] 一般不怎么用到，所以可以忽略先
if (mTouchDelegate != null) {
if (mTouchDelegate.onTouchEvent(event)) {
return true;
}
}

//[lxb #4] 查看view是否enable
//[lxb #4] 其实像FrameLayout RelativeLayout 是没有设置CLICKABLE， 在我们setOnclickListener之后才设置成CLICKABLE
//[lxb #4] CONTEXT_CLICKABLE 将会响应主触笔按下或鼠标右键单击这类的事件
if (((viewFlags & CLICKABLE) == CLICKABLE ||
(viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) ||
(viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE) {
switch (action) {
case MotionEvent.ACTION_UP:
//[lxb #5] 理解这个判断，最后先看 ACTION_DOWN
//[lxb #5] 指的是，如果view包裹在一个scrolling View中，可能会进行滑动处理，所以设置了一个prePress的状态
//[lxb #5] 大致是等待一定时间，然后没有被父类拦截了事件，则认为是点击到了当前的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;
//[lxb #6] 表示如果view是可以focus的，并且当前没有获得focus，则去申请获取focus
if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
focusTaken = requestFocus();
}

//[lxb #7] 设置点击态
//[lxb #7] 问：难道你们就没有疑问，为什么要在UP的时候才设置点击态，UP不是应该取消点击态才对吗？
//[lxb #7] 这个这是的前提是用户ACTION_DOWN在100ms（TAP_TIME）内UP了，才会到达这里
//[lxb #7] 在[lxb #15]标记的地方的CheckForTap中有取消该状态的操作
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);
}

//[lxb #8] 当前为LongPress
if (!mHasPerformedLongPress && !mIgnoreNextUpEvent) {
// This is a tap, so remove the longpress check
//[lxb #9] 取消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) {
//[lxb #] 执行点击，回调onClickListener的onClick,也就是我们经常使用的setOnClickListener中的操作
mPerformClick = new PerformClick();
}
if (!post(mPerformClick)) {
performClick();
}
}
}

if (mUnsetPressedState == null) {
//[lxb #10] 一个runnable，用于取消press状态
mUnsetPressedState = new UnsetPressedState();
}

//[lxb #11] 取消prePress引起的setPress
if (prepressed) {
postDelayed(mUnsetPressedState,
ViewConfiguration.getPressedStateDuration());
} else if (!post(mUnsetPressedState)) {
// If the post failed, unpress right now
mUnsetPressedState.run();
}

removeTapCallback();
}
mIgnoreNextUpEvent = false;
break;
//[lxb #12] 记录点击位置，并执行是否为LongPress的检测
case MotionEvent.ACTION_DOWN:
mHasPerformedLongPress = false;
//[lxb #12-2] 表示是否为鼠标右键操作，可以忽略，很少用到
if (performButtonActionOnTouchDown(event)) {
break;
}

// Walk up the hierarchy to determine if we're inside a scrolling container.
//[lxb #13] 查看是否在一个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.
//[lxb #14] 这里解释下几个状态分别是PFLAG_PREPRESSED、TAP_TIMEOUT、LONG_PRESS_TIME
//[lxb #14] 时间分别是 未知（比TAP时间短）、100ms、500ms
//[lxb #14] 0~100ms:prePress; 100~500:click状态； 500ms~：longClick
//[lxb #14] PFLAG_PREPRESSED： 表示view在srcolling view内，如果不超过这个时间，都没有点击态
//[lxb #14] TAP_TIMEOUT 表示，超过这个事件将算为点击
//[lxb #14] LONG_PRESS_TIME 表示超过这时间就执行LongClick操作
//[lxb #14] 如果是在一个scrolling view内
if (isInScrollingContainer) {
mPrivateFlags |= PFLAG_PREPRESSED;
if (mPendingCheckForTap == null) {
//[lxb #15] 检测是点击还是长点击
mPendingCheckForTap = new CheckForTap();
}
mPendingCheckForTap.x = event.getX();
mPendingCheckForTap.y = event.getY();
//[lxb #16] 执行检测操作，延迟100ms
postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
} else {
// Not inside a scrolling container, so show the feedback right away
//[lxb #17] 如果不在scrolling View中，则立马设为点击态
setPressed(true, x, y);
checkForLongClick(0);
}
break;

//[lxb #18] 将所有的状态设置为最初始
case MotionEvent.ACTION_CANCEL:
setPressed(false);
removeTapCallback();
removeLongPressCallback();
mInContextButtonPress = false;
mHasPerformedLongPress = false;
mIgnoreNextUpEvent = false;
break;
//[lxb #19] ACTION_MOVE动作下，仅仅做了将具体的坐标传递给背景以及判断点击区域是否还在view中
case MotionEvent.ACTION_MOVE:
//[lxb #20] 将实时位置传递给背景（前景）图片（Drawable）
drawableHotspotChanged(x, y);

// Be lenient about moving outside of buttons
//[lxb #21] 执行检测是否在当前的view中
//[lxb #22] 自定义view的过程中，通常没做这个操作，造成手离开了view，点击态还存在
if (!pointInView(x, y, mTouchSlop)) {
// Outside button
//[lxb #23]离开的view，则取消检测等操作
removeTapCallback();
if ((mPrivateFlags & PFLAG_PRESSED) != 0) {
// Remove any future long press/tap checks
removeLongPressCallback();

setPressed(false);
}
}
break;
}

return true;
}

return false;
}