Android事件监听器和回调方法

柔光的暖阳◎ 2021-12-09 23:31 629阅读 0赞

事件是 [Android][] 平台与用户交互的手段。当用户对手机进行操作时，会产生各种各样的输入事件，Android 框架捕获到这些事件，进而进行处理。  
  
Android 平台提供了多种用于获取用户输入事件的方式，考虑到用户事件都是在特定的用户界面中产生的，因此 Android 选用特定 View 组件来获取用户输入事件的方式，由 View 组件提供事件的处理方法。这就是为什么 View 类内部带有处理特定事件的监听器。

## 事件监听器 ##

监听器用于对特定事件进行监听，一旦监听到特定事件，则由监听器截获该事件，并回调自身的特定方法对事件进行处理。  
  
在教程之前的实例中，我们使用的事件处理方式都是监听器。根据用户输入方式的不同，View 组件将截获的事件分为 6 种，对应以下 6 种事件监听器接口。

1) OnClickListener 接口

此接口处理的是单击事件，例如，在 View 上进行单击动作，在 View 获得焦点的情况下单击“确定”按钮或者单击轨迹球都会触发该事件。  
  
当单击事件发生时，OnClickListener 接口会回调 public void onClick(View v) 方法对事件进行处理。其中参数 v 指的是发生单击事件的 View 组件。

2) OnLongClickListener 接口

此接口处理的是长按事件，当长时间按住某个 View 组件时触发该事件。  
  
其对应的回调方法为 public boolean onLongClick(View v)，当返回 true 时，表示已经处理完此事件，若事件未处理完，则返回 false，该事件还可以继续被其他监听器捕获并处理。

3) OnFocusChangeListener 接口

此接口用于处理 View 组件焦点改变事件。当 View 组件失去或获得焦点时会触发该事件。  
  
其对应的回调方法为 public void onFocusChange(View v, Boolean hasFocus)，其中参数 v 表示产生事件的事件源，hasFocus 表示事件源的状态，即是否获得焦点。

4) OnKeyListener 接口

此接口用于对手机键盘事件进行监听，当View获得焦点并且键盘被敲击时会触发该事件。  
  
其对应的回调方法为 public boolean onKey(View v, int keyCode, KeyEvent event)。  
  
方法参数说明：

*  keyCode 为键盘码。
 *  event 为键盘事件封装类的对象。

5) OnTouchListener 接口

此接口用来处理手机屏幕事件，当在 View 的范围内有触摸、按下、抬起、滑动等动作时都会触发该事件，并触发该接口中的回调方法。  
  
其对应的回调方法为 public boolean onTouch(View v, MotionEvent event)，对应的参数同上。

6) OnCreateContextMenuListener 接口

此接口用于处理上下文菜单被创建的事件。  
  
其对应的回调方法为 public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo info)，其中参数 menu 为事件的上下文菜单，参数 info 是该对象中封装了有关上下文菜单的其他信息。  
  
在之前Android菜单教程实例 MenusDemo 中（网址：[http://c.biancheng.net/view/3035.html][http_c.biancheng.net_view_3035.html]），创建上下文菜单使用的是 registerForContextMenu(View v)方法，其本质是为 View 组件 v 注册该接口，并实现了相应的回调方法。

## 回调事件响应 ##

在 Android 框架中，除了可以使用监听器进行事件处理之外，还可以通过回调机制进行事件处理。  
  
Android SDK 为 View 组件提供了 5 个默认的回调方法，如果某个事件没有被任意一个 View 处理，就会在 Activity 中调用响应的回调方法，这些方法分别说明如下。

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>说明/作用</th> 
   <th>调用时间</th> 
   <th>参数说明</th> 
   <th>返回值说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>public boolean onKeyDown(int keyCode, KeyEvent event)</td> 
   <td>接口 KeyEvent.Callback 中的抽象方法</td> 
   <td>键盘按键被按下时由系统调用</td> 
   <td> <p>keyCode 即键盘码，系统根据键盘码得知按下的是哪个按钮。</p> <p>event为按钮事件的对象，包含触发事件的详细信息。例如事件的类型、状态等</p> </td> 
   <td>true 已完成处理此事件<br> false 表示该事件还可以被其他监听器处理</td> 
  </tr> 
  <tr> 
   <td>public boolean onKeyUp(int keyCode, KeyEvent event)</td> 
   <td>接口 KeyEvent.Callback中的抽象方法</td> 
   <td>按钮向上弹起时被调用</td> 
   <td> <p>keyCode 即键盘码，系统根据键盘码得知按下的是哪个按钮。</p> <p>event为按钮事件的对象，包含触发事件的详细信息。例如事件的类型、状态等</p> </td> 
   <td>true 代表已完成处理此事件<br> false 表示该事件还可以被其他监听器处理</td> 
  </tr> 
  <tr> 
   <td>public boolean onTouchEvent(MotionEvent event)</td> 
   <td>方法在 View 中定义</td> 
   <td>用户触摸屏幕时被自动调用</td> 
   <td>event 为触摸事件封装类的对象，封装了该事件的相关信息<br> &nbsp; <p>当用户触摸到屏幕，屏幕被按下时，MotionEvent.getAction()的值为 MotionEvent.ACTION_ DOWN；</p> <p>&nbsp;</p> <p>当用户将触控物体离开屏幕时，MotionEvent.getAction() 的值为 MotionEvent.ACTION_UP；</p> <p>&nbsp;</p> <p>当触控物体在屏幕上滑动时，MotionEvent.getAction() 的值为 MotionEvent.ACTION_MOVE。</p> </td> 
   <td>true 表示事件处理完成<br> false 表示未完成</td> 
  </tr> 
  <tr> 
   <td>public boolean onTrackballEvent(MotionEvent event)</td> 
   <td>处理手机中轨迹球的相关事件。<br> 在 Activity 中重写，也可以在 View 中重写</td> 
   <td>&nbsp;</td> 
   <td>event 为手机轨迹球事件封装类的对象。</td> 
   <td>true 表示事件处理完成<br> false 表示未完成</td> 
  </tr> 
  <tr> 
   <td>protected void onFocusChanged(boolean gainFocus, int direction, Rect previouslyFocusedRect)</td> 
   <td>只能在 View 中重写，当 View 组件焦点改变时被自动调用</td> 
   <td>&nbsp;</td> 
   <td>gainFocus 表示触发该事件的 View 是否获得了焦点，获得焦点为 true。<br> 参数 direction 表示焦点移动的方向。<br> 参数 previouslyFocusedRect 是在触发事件的 View 的坐标系中前一个获得焦点的矩形区域</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

## 界面事件响应实例 ##

在之前的教程中，多次使用监听器对事件进行处理，应该此已经很熟悉了。  
  
接下来我们将通过一个实例来演示回调事件响应的处理过程，该实例 EventDemo 的运行效果如图 1 所示。

![实例EventDemo的运行效果][EventDemo]  
图 1 实例EventDemo的运行效果

其布局文件 main.xml 内容如下：

1.  <?xml version="l.0" encoding="utf-8"?>
2.  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
3.  android:layout\_width="fill\_parent"
4.  android:layout\_height="fill\_parent"
5.  android:orientation="vertical">
6.  
7.  <TextView
8.  android:layout\_width="fill\_parent"
9.  android:layout\_height="wrap\_content"
10. android:text="回调事件处理演示" />
11. 
12. <LinearLayout
13. android:layout\_width="wrap\_content"
14. android:layout\_height="wrap\_content"
15. android:orientation="horizontal">
16. 
17. <Button
18. android:id="@+id/button1"
19. android:layout\_width="wrap\_content"
20. android:layout\_height="wrap\_content"
21. android:focusableInTouchMode="true"
22. android:text="按钮1" />
23. 
24. <Button
25. android:id="@+id/button2"
26. android:layout\_width="wrap\_content"
27. android:layout\_height="wrap\_content"
28. android:focusableInTouchMode="true"
29. android:text="按钮2" />
30. 
31. <Button
32. android:id="@+id/button3"
33. android:layout\_width="wrap\_content"
34. android:layout\_height="wrap\_content"
35. android:focusableInTouchMode="true"
36. android:text="按钮3" />
37. </LinearLayout>
38. </LinearLayout>

当用户在屏幕上做移动触摸、单击按钮等操作时，主 Activity MainActivity 会捕获相应事件并进行处理，在 LogCat 中打印相关内容，运行效果如图 2 所示。

![Activity EventDemo捕获事件][Activity EventDemo]  
图 2 Activity EventDemo捕获事件

EventDemo.java代码如下：

纯文本复制

1.  package introduction.android.notidemo;
2.  
3.  import android.app.Activity;
4.  import android.content.Context;
5.  import android.graphics.Rect;
6.  import android.os.Bundle;
7.  import android.util.Log;
8.  import android.view.KeyEvent;
9.  import android.view.MotionEvent;
10. import android.view.View;
11. 
12. import android.view.View.OnFocusChangeListener;
13. import android.widget.Button;
14. import android.widget.Toast;
15. 
16. public class MainActivity extends Activity implements OnFocusChangeListener \{
17. Button\[\] buttons = new Button\[3\];
18. 
19. @Override
20. public void onCreate(Bundle savedInstanceState) \{
21. super.onCreate(savedInstanceState);
22. setContentView(R.layout.activity\_main);
23. 
24. buttons\[0\] = (Button) findViewById(R.id.button1);
25. buttons\[1\] = (Button) findViewById(R.id.button2);
26. buttons\[2\] = (Button) findViewById(R.id.button3);
27. for (Button button : buttons) \{
28. button.setOnFocusChangeListener(this);
29. \}
30. \}
31. 
32. //按钮按下触发的事件
33. public boolean onKeyDown(int keyCode, KeyEvent event) \{
34. switch (keyCode) \{
35. 
36. case KeyEvent.KEYCODE\_DPAD\_UP:
37. DisplayInformation("按上下方向键，KEYCODE\_DPAD\_UP");
38. break;
39. case KeyEvent.KEYCODE\_DPAD\_DOWN:
40. DisplayInformation("按上下方向键,KEYCODE\_\_DPAD\_UP");
41. break;
42. \}
43. return false;
44. \}
45. 
46. //按钮弹起触发的案件
47. public boolean onKeyUp(int keyCode, KeyEvent event) \{
48. switch (keyCode) \{
49. 
50. case KeyEvent.KEYCODE\_DPAD\_UP:
51. DisplayInformation("松开上方向键,KEYCODE\_DPAD\_UP");
52. break;
53. case KeyEvent.KEYCODE\_DPAD\_DOWN:
54. DisplayInformation("松开下方向键,KEYCODE\_DPAD\_UP");
55. break;
56. \}
57. return false;
58. \}
59. 
60. //触摸事件
61. public boolean onTouchEvent(MotionEvent event) \{
62. switch (event.getAction()) \{
63. case MotionEvent.ACTION\_DOWN:
64. DisplayInformation("手指正在往屏幕上按下");
65. break;
66. 
67. case MotionEvent.ACTION\_MOVE:
68. DisplayInformation("手指正在往屏幕上移动");
69. break;
70. case MotionEvent.ACTION\_UP:
71. DisplayInformation("手指正在往屏幕上按抬起");
72. break;
73. \}
74. return false;
75. 
76. \}
77. 
78. //焦点事件
79. @Override
80. public void onFocusChange(View view, boolean arg1) \{
81. switch (view.getId()) \{
82. case R.id.button1:
83. DisplayInformation("第一个按钮获得了焦点");
84. break;
85. case R.id.button2:
86. DisplayInformation("第二个按钮获得了焦点");
87. break;
88. case R.id.button3:
89. DisplayInformation("第三个按钮获得了焦点");
90. break;
91. \}
92. \}
93. 
94. //显示Toast
95. public void DisplayInformation(String string) \{
96. //Toast.makeText (EventDemo.this,string,Toast.LENGTH\_SHORT).show();
97. Log.i("enentDemo", string);
98. \}
99. \}

[Android]: http://c.biancheng.net/android/
[http_c.biancheng.net_view_3035.html]: http://c.biancheng.net/view/3035.html
[EventDemo]: /images/20211209/99a06bf2c2704f8e9fef58a921f96e28.png
[Activity EventDemo]: /images/20211209/ca1e8f8b107943a4b9d415d15c4ac12c.png