Android触摸事件-01View触摸事件及源码分析

API

  • dispatchTouchEvent()和onTouchEvent(): dispatchTouchEvent()是传递触摸事件的API, 而onTouchEvent()则是View处理触摸事件的API。View中dispatchTouchEvent()将事件传递给"自己的onTouch()", "自己的onTouchEvent()"进行处理。 onTouch()是OnTouchListener接口 中API,属于View提供的,让用户自己处理触摸事件的接口,而onTouchEvent()是Android系统提供的, 用于处理触摸事件的接口;在onTouchEvent()中会进行一系列的动作,例如获取焦点、设置按下状态, 调用onClick()等

  • OnTouchListener, OnClickListener, OnLongClickListener等接口: 这部分主要是接口。onTouch()与onTouchEvent()都是用户处理触摸事件的API。但不同的是:(01), onTouch()是View提供给用户,让用户自己处理触摸事件的接口。而onTouchEvent()是Android系统自己实现的接口。(02),onTouch()的优先级比onTouchEvent()的优先级更高。dispatchTouchEvent()中分发事件的时候,会先将事件分配给onTouch()进行处理,然后才分配给onTouchEvent()进行处理。 如果onTouch()对触摸事件进行了处理,并且返回true;那么,该触摸事件就不会分配在分配给onTouchEvent()进行处理了。只有当onTouch()没有处理,或者处理了但返回false时,才会分配给onTouchEvent()进行处理

dispatchTouchEvent

源码

    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)) {
            //必须ENABLED,才会去执行设置的OnTouchListener
            ListenerInfo li = mListenerInfo;
            if (li != null && li.mOnTouchListener != null
                    && (mViewFlags & ENABLED_MASK) == ENABLED
                    && li.mOnTouchListener.onTouch(this, event)) {
                result = true;
            }

            //分发顺序,先onTouch,如果返回false,才会onTouchEvent
            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;
    }
  • 如果将事件进行分发的话,会先尝试分发给onTouch();然后才分发给onTouchEvent()
  • 如果View是DISABLED的,即使设置了onTouch也不会执行

onFilterTouchEventForSecurity

  • onFilterTouchEventForSecurity()表示是否要分发该触摸事件;如果该View不是位于顶部,并且有设置属性使该View不在顶部时不响应触摸事件,则不分发该触摸事件,即不会执行onTouch()与onTouchEvent()。 否则的话,则将事件分发给onTouch(), onTouchEvent()进行处理。
public boolean onFilterTouchEventForSecurity(MotionEvent event) {
    //noinspection RedundantIfStatement
    if ((mViewFlags & FILTER_TOUCHES_WHEN_OBSCURED) != 0
            && (event.getFlags() & MotionEvent.FLAG_WINDOW_IS_OBSCURED) != 0) {
        // Window is obscured, drop this touch.
        return false;
    }
    return true;
}
  • FILTER_TOUCHES_WHEN_OBSCURED是android:filterTouchesWhenObscured属性所对应的位。android:filterTouchesWhenObscured是true的话,则表示其他视图在该视图之上,导致该视图被隐藏时,该视图就不再响应触摸事件。
  • MotionEvent.FLAG_WINDOW_IS_OBSCURED为true的话,则表示该视图的窗口是被隐藏的。

onTouchEvent

public boolean onTouchEvent(MotionEvent event) {
        final float x = event.getX();
        final float y = event.getY();
        final int viewFlags = mViewFlags;

        if ((viewFlags & ENABLED_MASK) == DISABLED) {
            if (event.getAction() == MotionEvent.ACTION_UP && (mPrivateFlags & PFLAG_PRESSED) != 0) {
                setPressed(false);
            }
            // 一个DISABLED的,但是是CLICKABLE或LONG_CLICKABLE的,也会消费掉事件
            return (((viewFlags & CLICKABLE) == CLICKABLE ||
                    (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE));
        }

        //代理
        if (mTouchDelegate != null) {
            if (mTouchDelegate.onTouchEvent(event)) {
                return true;
            }
        }

        if (((viewFlags & CLICKABLE) == CLICKABLE ||
                (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) {
            switch (event.getAction()) {
                case MotionEvent.ACTION_UP:
                    boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
                    if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
                        //如果有PFLAG_PRESSED,或者PFLAG_PREPRESSED,尝试获取焦点
                        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);
                       }

                        // 不是长按事件
                        //可能是时长不够,也可能时长够了,没有设置OnLongClickListener,或者OnLongClickListener返回为false
                        //所以如果要想只处理长按,不处理click,OnLongClickListener应当返回为true             
                        if (!mHasPerformedLongPress) {

                            removeLongPressCallback();

                            // 如是获取焦点失败,才会有可能执行OnClickListener
                            // 可以参考Edittext
                            if (!focusTaken) {
                                //这里有可能按下的效果还没有显示出来,
                                //所以将执行OnClickListener的动作交由Handler去处理,实际上放到了后面去处理
                                if (mPerformClick == null) {
                                    mPerformClick = new PerformClick();
                                }
                                //!!!!!放到MessagQueue中去
                                if (!post(mPerformClick)) {
                                    performClick();
                                }
                            }
                        }

                        if (mUnsetPressedState == null) {
                            mUnsetPressedState = new UnsetPressedState();
                        }

                        //!!!!用postDelayed,回复原来
                        if (prepressed) {
                            postDelayed(mUnsetPressedState,
                                    ViewConfiguration.getPressedStateDuration());
                        } else if (!post(mUnsetPressedState)) {
                            // If the post failed, unpress right now
                            mUnsetPressedState.run();
                        }

                        removeTapCallback();
                    }
                    break;

                case MotionEvent.ACTION_DOWN:
                    mHasPerformedLongPress = false;

                    if (performButtonActionOnTouchDown(event)) {
                        break;
                    }

                    // 判断是否在一个可以滑动的容器内部
                    boolean isInScrollingContainer = isInScrollingContainer();

                    //如果在一个滑动的容器的内部,因为即将有可能是一个滑动事件,所以要过一段时间去判断这是否是一个点击事件
                    //也就是过一段时间去设置按下状态,设置PFLAG_PREPRESSED标识
                    if (isInScrollingContainer) {
                        mPrivateFlags |= PFLAG_PREPRESSED;
                        if (mPendingCheckForTap == null) {
                            mPendingCheckForTap = new CheckForTap();
                        }
                        mPendingCheckForTap.x = event.getX();
                        mPendingCheckForTap.y = event.getY();
                        //!!!!精髓的用postDelayed
                        postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
                    } else {
                        // 如果不是在一个滑动容器内部,则直接设置按下状态和PFLAG_PREPRESSED标志
                        //设置检验长按的Runnable
                        setPressed(true, x, y);
                        checkForLongClick(0);
                    }
                    break;

                case MotionEvent.ACTION_CANCEL:
                    setPressed(false);
                    removeTapCallback();
                    removeLongPressCallback();
                    break;

                case MotionEvent.ACTION_MOVE:
                    drawableHotspotChanged(x, y);

                    // 如是移出了View的范围外
                    if (!pointInView(x, y, mTouchSlop)) {
                        //不用继续检测是否是按下动作
                        removeTapCallback();
                        if ((mPrivateFlags & PFLAG_PRESSED) != 0) {
                            //如果已经是按下了,则不用继续检测是否是长按
                            removeLongPressCallback();

                            setPressed(false);
                        }
                    }
                    break;
            }

            return true;
        }

        return false;
    }
  • 一个View如果是DISABLED的,则返回它是否可以点击。如果View是DISABLED的,但是它是CLICKABLE/LONG_CLICKABLE,它不会对事件有反应,但是它会消费掉触摸事件。

  • 当我们调用了setEnabled(false)时,View就被禁用了;默认情况下,View是可用的。当调用setClickable(true)或者android:clickable为true时,View就是可点击状态;默认情况下,一个View如是是不可点击的,也不能够长按

    public void setClickable(boolean clickable) {
          setFlags(clickable ? CLICKABLE : 0, CLICKABLE);
      }
    
    public void setLongClickable(boolean longClickable) {
          setFlags(longClickable ? LONG_CLICKABLE : 0, LONG_CLICKABLE);
      }
    
  • 如果该View的mTouchDelegate不为null的话,将触摸消息分发给mTouchDelegate。例如,假设有两个视图v1和v2,它们的布局相互之间不重叠;如果设置了v1.setTouchDelegate(v2)的话,v1的触摸事件就会分发给v2。

  • 对于ACTION_DOWN事件,要根据容器是否可以滑动区分处理

  • 对于ACTION_MOVE事件,如果触摸点跑到了View的范围外,则要清除掉点击的标识,清除掉相应的视觉效果,当然也不用继续去测试是否是长按

  • 对于ACTION_UP事件,如果已经有PFLAG_PRESSED或PFLAG_PREPRESSED的标志,则尝试获取焦点,如果获取失败并且这次点击时长不足以当作一次长按事件(或者是长按事件,但是OnLongClickListener返回为false),才会去执行OnClickListener

  • 在这里最精髓的是使用Handler去判断是否是点击,是否是长按,去执行onClick,去执行onLongClick

总结

  • View中的dispatchTouchEvent()会将事件传递给"onTouch()", "onTouchEvent()"进行处理。而且onTouch()的优先级比onTouchEvent()的优先级要高。

  • onTouch()与onTouchEvent()有两个不同之处:

    • 如果View是DISABLED的,即使设置了onTouch也不会执行,而onTouchEvent则会返回是否可以点击/是否可以长按。因此如果你有一个控件是DISABLED的,那么给它注册onTouch事件将永远得不到执行,对于这一类控件,如果我们想要监听它的touch事件,就必须通过在该控件中重写onTouchEvent方法来实现
    • onTouch()的优先级比onTouchEvent()的优先级更高。如果onTouch()对触摸事件进行了处理,并且返回true;那么,该触摸事件就不会分配在分配给onTouchEvent()进行处理了。只有当onTouch()没有处理,或者处理了但返回false时,才会分配给onTouchEvent()进行处理。

推荐阅读更多精彩内容