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;
    }


©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页