Android事件处理机制(1)-输入事件

最近希望能系统的学习并整理Android的事件分发流程。这是第一篇文章，当然是从Android Develpers开发文档中学习啦。

Android系统中，为了在用户和视图界面之间进行交互，需要截获用户的触摸事件。安卓的View类定义了一系列的嵌套接口来帮助开发者来轻松定义回调，这就是事件侦听器（event listener）。
事件侦听器在大部分的应用场景中可以满足侦听用户与UI交互的需要，但某些场景需要构建自定义组件，这就需要使用事件处理程序（event handlers）来定义组件默认的事件行为。

事件侦听器

事件侦听器是View 类中包含一个回调方法的接口。 当用户与 UI 项目之间的交互触发已注册此视图的侦听器时，Android 框架将调用这些方法。

各事件侦听器接口包含的回调方法如下：

• onClick()
  在View.OnClickListener 中。 当用户触摸项目（处于触摸模式下）时，或者使用导航键或轨迹球聚焦于项目，然后按适用的“Enter”键或按下轨迹球时，将调用此方法。

• onLongClick()
  在View.OnLongClickListener 中。 当用户触摸并按住项目（处于触摸模式下）时，或者使用导航键或轨迹球聚焦于项目，然后按住适用的“Enter”键或按住轨迹球（持续一秒钟）时，将调用此方法。

• onFocusChange()
  在View.OnFocusChangeListener 中。 当用户使用导航键或轨迹球导航到或远离项目时，将调用此方法。

• onKey()
  在View.OnKeyListener 中。 当用户聚焦于项目并按下或释放设备上的硬按键时，将调用此方法。

• onTouch()
  在View.OnTouchListener 中。 当用户执行可视为触摸事件的操作时，其中包括按下、释放或屏幕上的任何移动手势（在项目边界内），将调用此方法。

• onCreateContextMenu
  在View.OnCreateContextMenuListener 中。 当（因持续“长按”而）生成上下文菜单时，将调用此方法。请参见菜单开发者指南中有关上下文菜单的阐述。

这些方法是其相应接口的唯一成员。要定义其中一个方法并处理事件，请在 Activity 中实现嵌套接口或将其定义为匿名类。然后，将实现的实例传递给相应的 View.set...Listener() 方法。相信安卓开发者对事件侦听器的使用方法都很熟悉。

部分事件侦听器的方法回调没有返回值，部分则必须返回布尔值。原因参考如下：

• onLongClick()：此方法返回一个布尔值，表示您是否已处理完事件，以及是否应该将它继续传下去。 也就是说，返回 true 表示您已经处理事件且事件应就此停止；如果您尚未处理事件和/或事件应该继续传递给其他任何点击侦听器，则返回 false。
• onKey()：此方法返回一个布尔值，表示您是否已处理完事件，以及是否应该将它继续传下去。 也就是说，返回 true 表示您已经处理事件且事件应就此停止；如果您尚未处理事件和/或事件应该继续传递给其他任何按键侦听器，则返回 false。
• onTouch()： 此方法返回一个布尔值，表示侦听器是否处理完此事件。重要的是，此事件可以拥有多个分先后顺序的操作。 因此，如果在收到关闭操作事件时返回 false，则表示您并未处理完此事件，而且对其后续操作也不感兴趣。 因此，您无需执行事件内的任何其他操作，如手势或最终操作事件。

注：Android 会先调用事件处理程序，然后从类定义调用合适的默认处理程序。 因此，从这些事件侦听器返回 true 会停止将事件传播到其他事件侦听器，还会阻止回调视图对象中的默认事件处理程序。 因此，在返回 true 时请确保您要终止事件。

View的dispatchTouchEvent源码解析

我们知道View都是通过dispatchTouchEvent方法来分发触摸事件的，下面是View的相关代码，注意只保留了主要逻辑。

    /**
     * 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 (onFilterTouchEventForSecurity(event)) {
            ...//省略部分代码
            //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;
            }
        }
        ...//省略部分代码
        return result;
    }

li.mOnTouchListener即为setOnTouchListener方法里赋值的对象，(mViewFlags & ENABLED_MASK) == ENABLED是判断当前点击的控件是否enable，默认按钮都是enable的。上述两个条件满足，则会调用li.mOnTouchListener.onTouch方法。根据接下来的代码可知，只有我们在onTouch方法中false，才能执行onTouchEvent方法，进而触发onClick、onLongClick方法。

笔记:如果对一个View同时设置了OnTouchListener和OnClickListener，onTouch方法的执行早于onClick方法，且onTouch方法的返回值会影响onClick方法的触发。如果onTouch方法返回true，则onClick方法将不会被触发。在默认情况下onTouch方法返回false，可以接收View的界面内发生的所有Touch事件，且此时可触发onClick方法。onTouch事件一般包含几个有先后顺序的操作，常见的如（ACTION_DOWN，ACTION_UP）、（ACTION_DOWN，ACTION_MOVE...ACTION_MOVE，ACTION_UP）。一旦返回false则表示您并未处理完此事件，且对后续操作不感兴趣，但是onTouch会按顺序接收到完整的一系列Touch事件。

事件处理程序

当从视图构建自定义组件时，能够定义几种用作默认事件处理程序的回调方法。用于事件处理的常见回调，包括

• onKeyDown(int, KeyEvent)：在发生新的按键事件时调用
• onKeyUp(int, KeyEvent)：在发生按键弹起事件时调用
• onTrackballEvent(MotionEvent)：在发生轨迹球运动事件时调用
• onTouchEvent(MotionEvent)：在发生触摸屏运动事件时调用
• onFocusChanged(boolean, int, Rect)：在视图获得或失去焦点时调用

还有一些其他方法值得您注意，尽管它们并非 View 类的一部分，但可能会直接影响所能采取的事件处理方式。 因此，在管理布局内更复杂的事件时，请考虑使用以下其他方法：

• Activity.dispatchTouchEvent(MotionEvent)：此方法允许Activity在分派给窗口之前截获所有触摸事件。
• ViewGroup.onInterceptTouchEvent(MotionEvent)：此方法允许ViewGroup监视分派给子视图的事件。
• ViewParent.requestDisallowInterceptTouchEvent(boolean)： 对父视图调用此方法表明不应使用 onInterceptTouchEvent(MotionEvent)截获触摸事件。

触摸模式

当用户使用方向键或轨迹球导航用户界面时，必须聚焦到可操作项目上（如按钮），以便用户看到将接受输入的对象。 但是，如果设备具有触摸功能且用户开始通过触摸界面与之交互，则不再需要突出显示项目或聚焦到特定视图对象上。 因此，有一种交互模式称为“触摸模式”。

对于支持触摸功能的设备，当用户触摸屏幕时，设备会立即进入触摸模式。 自此以后，只有isFocusableInTouchMode()为 true 的视图才可聚焦，如文本编辑小部件。其他可触摸的视图（如按钮）在用户触摸时不会获得焦点；按下时它们只是触发点击侦听器。

无论何时，只要用户点击方向键或滚动轨迹球，设备就会退出触摸模式并找到一个视图使其获得焦点。 现在，用户可在不触摸屏幕的情况下继续与用户界面交互。

整个系统（所有窗口和 Activity）都将保持触摸模式状态。要查询当前状态，您可以调用isInTouchMode()来检查设备目前是否处于触摸模式。