最近希望能系统的学习并整理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()来检查设备目前是否处于触摸模式。