【Android UI】捕捉输入控件事件

图灵的梦 2013-07-08

原文自:http://android.eoe.cn/topic/ui

 

在Android中有多种方法可以用来拦截用户与程序的交互事件。如果想处理用户界面中触发的事件,可以通过从用户交互的View捕获事件来实现。View这个类提供了这些方法。

在用来构成布局的各种View类中,我们可以看到有几个用于UI事件的公共回调方法。当这些对象中有用户行为产生时,Android框架就会调用相应的回调方法。例如,当一个view(比如一个按钮Button)被触摸了,那么它的onTouchEvent()方法就会被调用。但是,为了拦截到这个事件,你必须扩展这个类并重写这些方法。然而,为了处理这样一个事件就扩展每一个View对象是不实际的。这就是为什么View类还提供了包含一些很方便定义的回调方法的嵌套接口的原因。这些叫做事件监听器(event listener)接口就是你拦截UI交互事件的入口。

虽然多数情况下使用事件监听器来监听用户交互,但是有时候为了创建一个自定义的组件,也需要扩展一个View类。比如你可能想要扩展一个Button类来使它更好用。这种情况下,你就可以使用事件处理器(event handler)来定义默认的事件行为。

事件监听器

一个事件监听器是View类中一个包含单一回调方法的接口。当注册了监听器的View发生了跟监听器对应的UI交互事件时,Android框架就会调用这些回调方法。

事件监听器接口中包含了以下回调方法:

onClick()

:来自View.OnClickListener接口。当用户触摸了一个对象(在触摸模式下),或者通过导航键或轨迹球使它获得焦点后再按下兼容"enter"的按键或是按下轨迹球,这个方法被调用。

onLongClick()

:来自View.OnLongClickListener接口。当用户在一个对象上触摸并按住不放(触摸模式下),或者通过导航键或轨迹球使它获得焦点后再按下兼容"enter"的按键或是轨迹球并按住不放(一秒钟时间),这个方法被调用。

onFocusChange()

:来自View.OnFocusChangeListener。当用户使用导航键或者轨迹球导航到一个对象或离开一个对象时,这个方法被调用。

onKey()

:来自View.OnKeyListener接口。当用户让焦点落在一个对象上后按下或释放设备上的一个键时,这个方法被调用。

onTouch()

:来自View.OnTouchListener接口,当用户执行一个触屏事件的动作时,包括按下动作、释放动作,或者任何在屏幕上的手势(当然必须在对象所在的区域内),这个方法被调用。

onCreateContextMenu()

:来自View.OnCreateContextMenuListener接口。当一个上下文菜单被创建(长按后的结果)时,这个方法被调用。关于上下文菜单的更多讨论,请参考关于Menus | 菜单 - Menus的开发指南。

这些方法是各自接口的唯一成员。如果要定义这些方法来处理事件,就要在Activity中实现这些嵌套接口,或者定义一个匿名内部类。然后,把你实现的实例传递给对应的View.set…Listener()方法。(例如,以实现的OnClickListener作为参数调用setOnClickListener()方法)。

下面的例子演示了如何给一个Button注册一个on-click监听器:

// 创建一个实现了OnClickListener的匿名内部类的对象
private OnClickListener mCorkyListener = new OnClickListener() {
public void onClick(View v) {
// do something when the button is clicked
}
};

protected void onCreate(Bundle savedValues) {
...
// 从布局中找到需要的按钮
Button button = (Button)findViewById(R.id.corky);
// 用上面实现的对象注册点击监听器
button.setOnClickListener(mCorkyListener);
...
}

你可能也发现把OnClickListener作为Activity的一部分来实现会更方便。这样可以避免额外的类加载和对象内存分配。如:

public class ExampleActivity extends Activity implements OnClickListener {
protected void onCreate(Bundle savedValues) {
...
Button button = (Button)findViewById(R.id.corky);
button.setOnClickListener(this);
}

1
2
3
4
5
// 实现OnClickListener的回调
public void onClick(View v) {
  // 这里做按钮点击后需要做的事情
}
...

}

注意上例中的onClick()回调方法没有返回值,但是有些其他的事件监听器方法必须要返回一个布尔值。具体情况取决于事件。以下是针对部分情况进行说明:
* onLongClick() - 这个方法返回一个布尔值,用来指明这个事件是否已经被你消耗(使用)了而不应进一步传递。也就是说,如果返回true,表明你已经处理了这个事件,并且事件应该就此停止;如果返回false,表明你没有处理这个事件,并且/或者这个事件应该继续传递给其他的on-click监听器来处理。
* onKey() - 这个方法返回一个布尔值,用来指明这个事件是否已经被你消耗了而不应进一步传递。也就是说,如果返回true,表明你已经处理了这个事件,并且事件应该就此停止;如果返回false,表明你没有处理这个事件,并且/或者这个事件应该继续传递给其他的on-key监听器来处理。
* onTouch() - 这个方法返回一个布尔值,用来指明你的监听器是否消耗这个事件。重要的是这个事件可能包含多个彼此跟随的动作。因此,如果在接收到按下动作事件时返回了false,表明你不使用这个事件,并且对这个事件中按下动作的后续动作也不感兴趣了。这样的话,你将不会再为这个事件中的任何其他动作调用这个方法,比如手势或者结束动作事件。

记住,硬件按键事件始终是发送给当前焦点所在的View。它们从View层次结构的最顶层开始从上而下派发,直到到达合适的目标。如果你当前的View(或View的子视图)有焦点,那么通过dispatchKeyEvent()方法你能够看到事件的派发路线。通过View捕获按键事件的另一个方法是,你可以在Activity内部通过onKeyDown()和onKeyUp()两个方法来接受所有的按键事件。

而且,当考虑到程序的文本输入的时候,请注意许多设备只有软键盘输入法。这些输入法不要求必须有实体按键;一些设备可能使用语音输入、手写输入等等。即使一个输入法展现了像实体键盘一样的界面,通常它也不会触发onKeyDown()一类的事件。你永远不应该让你的UI依赖特定的按键来实现操作,除非你想将你的程序限制在拥有实体键盘的设备上。尤其,不要依赖在这些按键上按下return键来确认输入;而应该用IME_ACTION_DONE一类的动作来表示输入法完成了程序中你想要的动作,以便程序用应有的方式来改变UI。不用去猜测软键盘工作的方式,只相信它会为程序提供格式化的文本就够了。

注意:Android会首先调用事件处理器,然后再调用类定义的合适的默认处理程序。这样,如果这些事件监听器返回了true,那么事件向其他事件监听器的传递会被中止,View中默认的事件处理程序的回调也会被阻止。因此,当你却确信要中止一个事件的时候才返回true。

事件处理器

如果你要从View构建一个自定义的组件,你可以定义几个回调方法作为默认的事件处理器。在Custom Components | 自定义组件 - Custom Components文档中,你可以学到一些用来处理事件的常用回调,包括:
* onKeyDown(int, KeyEvent) - 当新的按键事件产生的时候调用
* onKeyUp(int, KeyEvent) - 当一个按键松开事件产生的时候调用
* onTrackballEvent(MotionEvent) - 当轨迹球滚动的时候调用
* onTouchEvent(MotionEvent) - 当触屏动作产生时调用
* onFocusChanged(boolean, int, Rect) - 当View获取或者失去焦点的时候调用
另外还有一些需要注意的方法,它们不属于View类,但是能够直接影响到你处理事件的方式。因此,当你管理布局中更复杂的事件的时候,考虑下面这些方法:
* Activity.dispatchTouchEvent(MotionEvent) - 这个方法允许Activity在触屏事件被传递到window之前拦截它们。
* ViewGroup.onInterceptTouchEvent(MotionEvent) - 这个方法允许ViewGroup查看传递到它的子view的触屏事件。
* ViewParent.requestDisallowInterceptTouchEvent(boolean) - 在父View中调用这个方法来表明它不应该使用onInterceptTouchEvent(MotionEvent)来拦截触屏事件。

触摸模式

当用户使用方向键或者轨迹球浏览到一个用户界面的时候,就需要把焦点交给可交互的对象(比如按钮)以便用户能够看到这些对象能够接受输入。但是,如果一个设备支持触摸,并且用户通过触摸来实现交互,那么就不必高亮显示这些对象或者把焦点交给某个View了。这样,就有了一个名为触摸模式的交互模式了。

对一个支持触摸的设备,一旦用户触摸了屏幕,设备就进入了触摸模式。从此,只要一个View的isFocusableInTouchMode()方法返回值为true,那它就是可以获得焦点的,比如一个文本编辑框。其他可以触摸的View比如按钮,在被触摸的时候是不会获得焦点的;它们仅仅是在按下的时候触发一下它们on-click监听器。

每当用户点击了一个方向键或者滚动轨迹球的时候,设备就将退出触摸模式,并寻找一个View让其获得焦点。现在,用户就恢复到了不需要触摸屏的交互模式了。

触摸模式的状态是整个系统维护的(所有的窗口和活动视图)。要查看当点设备所处的触摸模式状态,可以调用isInTouchMode()方法得到当前设备是否处于触摸模式。

处理焦点

Android框架会处理焦点的移动来响应用户的输入,包括当View被删除或隐藏,或者新的View变得可见时的焦点变化。View通过isFocusable()方法来表明它们是否希望获得焦点。通过调用setFocusable()方法来设置一个View能否获得焦点。在触摸模式下,你通过isFocusableInTouchMode()方法查询一个View是否允许获得焦点。当然你可以通过调用setFocusableInTouchMode()方法来改变设置。

焦点的移动是基于一种在特定方向查找最近的可接受焦点的View的算法。在某些不常见的情况下,这种默认的算法找到的焦点可能与开发者的期望表现不一致。这时,你就要在下面的布局文件中的xml属性来精确指定焦点的移动:nextFocusDown, nextFocusLeft, nextFocusRight, 以及 nextFocusUp。给将要失去焦点的View添加一个上面的属性,在属性值中定义下一个将要获得焦点的View的id。比如:




通常,在这样一个垂直布局中,从第一个按钮向上浏览不会到任何地方,同样从第二个按钮向下浏览也不会到任何地方。现在,top按钮定义下一个向上导航的焦点获得者为bottom按钮(反之亦然),这样焦点就可以在这两个按钮之间上下循环了。

如果你习惯在UI中声明一个默认拥有焦点的View(通常不这样做),就需要在布局声明文件中给这个View添加一个android:focusable属性并把这个属性值设置为true。你也可以在触摸模式中使用android:focusableInTouchMode属性来定义默认拥有焦点的View。

要强制让某个View获得焦点,调用它的requestFocus()方法。

 

就像上面“事件监听器”章节讨论的一样,使用onFocusChange()方法来监听焦点变化事件(当一个View获取到或者失去焦点的时候会发出通知)。

相关推荐