Android菜单：选项菜单+上下文菜单+子菜单

菜单是人机交互的重要接口，在 Android SDK 中，提供了菜单类 android.view.Menu，以完成与菜单有关的操作。

Android SDK 提供三种菜单，分别如下。

1）Options Menu：选项菜单。
是 Activity 的主要菜单项的集合，当用户单击 Menu 按钮时出现。

在 Android 2.3 以下的版本中，这种菜单最多显示 6 个带图标的菜单项。当菜单中含有 6 个以上的菜单项时，弹出菜单将只显示前 5 个菜单项，第 6 个菜单项会变为 More，单击 More 菜单项后会出现扩展菜单。

扩展菜单不支持图标，但支持单选框和复选框。在 Android 3.0（API Level 11）及以上版本中，默认情况下直接弹出的选项菜单不再显示图标。

2）Context Menu：上下文菜单。
是一个悬浮的菜单项列表，当用户单击注册了上下文菜单的组件时出现。上下文菜单不支持菜单图标和快捷键。

3）Submenu：子菜单。
是某个菜单项的扩展，是一个悬浮的菜单项列表。子菜单不支持菜单图标或者嵌套子菜单。

Options Menu

要实现选项菜单的功能，首先需要重载 OnCreatOptionsMenu() 方法创建菜单，然后通过 onOptionsItemSelected() 方法对菜单被单击事件进行监听和处理。

创建一个名为 MenusDemo 的 Android Project，在该工程中对菜单的相关知识进行学习。

在工程的 res 目录下创建一个 menu 目录，用于存放菜单相关的 XML 文件。在该目录下创建 mymenu.xml，代码如下：

1. <?xml version="1.0" encoding="utf-8"?>
2. <menu xmlns:android="http://schemas.android.com/apk/res/android"
3. android:layout_width="wrap_content"
4. android:layout_height="wrap_content">
5.  
6. <item
7. android:id="@+id/item1"
8. android:icon="@drawable/icon01"
9. android:title="@string/menuitem1" />
10.  
11. <item
12. android:id="@+id/item2"
13. android:icon="@drawable/icon02"
14. android:title="@string/menuitem2" />
15.  
16. <item
17. android:id="@+id/item3"
18. android:icon="@drawable/icon03"
19. android:title="@string/menuitem3" />
20.  
21. <item
22. android:id="@+id/item4"
23. android:icon="@drawable/icon04"
24. android:title="@string/menuitem4" />
25.  
26. <item
27. android:id="@+id/item5"
28. android:icon="@drawable/icon05"
29. android:title="@string/menuitem5" />
30.  
31. <item
32. android:id="@+id/item6"
33. android:icon="@drawable/icon06"
34. android:title="@string/menuitem6" />
35.  
36. <item
37. android:id="@+id/item7"
38. android:icon="@drawable/icon07"
39. android:title="@string/menuitem7" />
40. </menu>

mymenu.xml 创建了一个具有 7 个菜单项的菜单。
1）通过 android:id 属性为每个菜单项指定 ID。
2）通过 android:title 属性为每个菜单项指定显示的菜单项内容。
3）通过 android:icon 属性指定每个菜单项的图标。对应的图标文件放置到 res/drawable 目录下。

为工程 MenusDemo 创建名为 MenusActivity 的 Activity，将 mymenu.xml 中定义的菜单设置为 MenusActivity 的菜单，重载 OnCreatOptionsMenu() 方法。

MenusActivity.java 的代码如下：

1. package introduction.android.menusdemo;
2.  
3. import android.support.v7.app.AppCompatActivity;
4. import android.os.Bundle;
5. import android.view.Menu;
6. import android.view.MenuInflater;
7. import android.view.MenuItem;
8. import android.widget.TextView;
9.  
10. public class MainActivity extends AppCompatActivity {
11. private TextView textview;
12.  
13. /**
14. * Called when the activity is first created.
15. */
16. @Override
17. public void onCreate(Bundle savedInstanceState) {
18. super.onCreate(savedInstanceState);
19. setContentView(R.layout.activity_main);
20. textview = (TextView) findViewById(R.id.text);
21. }
22.  
23. @Override
24. public boolean onOptionsItemSelected(MenuItem item) {
25. // TODO Auto-generated method stub
26. switch (item.getItemId()) {
27. case R.id.item1:
28. textview.setText("iteml selected!");
29. break;
30. case R.id.item2:
31. textview.setText("item2 selected!");
32. break;
33. case R.id.item3:
34. textview.setText("item3 selected!");
35. break;
36. default:
37. break;
38. }
39. return super.onOptionsItemSelected(item);
40. }
41.  
42. @Override
43. public boolean onCreateOptionsMenu(Menu menu) {
44. MenuInflater inflater = getMenuInflater();
45. inflater.inflate(R.menu.mymenu, menu);
46. return true;
47. }
48. }

其中：

1. public boolean onCreateOptionsMenu(Menu menu) {
2. MenuInflater inflater = getMenuInflater();
3. inflater.inflate(R.menu.mymenu, menu);
4. return true;
5. }

这几行代码通过 MenuInflater.Inflate() 方法将 menu.xml 中定义的菜单项内容填充到了菜单中。

在 OnCreatOptionsMenu() 方法中创建菜单时也支持 Menu.add() 方法，也能达到同样目的。例如：

menu.add(0,itemid,0,item_title);

表示在菜单中添加一个菜单项，该菜单项的 ID 为 itemid，菜单项显示的内容为 item_title 的内容。但是不鼓励使用这种方式，而应该使用 XML 文件来创建菜单。

运行 MenusDemo 实例，单击手机的 Menu 按钮，得到的效果如图 1 所示。
 

图 1“Menu”按钮运行效果

由运行效果可见，MenusActivity 已经根据 mymenu.xml 文件创建了一个具有 7 个菜单项的菜单。但是虽然在 mymenu.xml 文件中为每个菜单项指定了一个图标，但是生成的选项菜单中却并没有图标被显示出来，这是为什么呢？

实例 MenusDemo 当前的运行环境是 Android 4.0，其 API Level 为 14。我们先看一下，同样的代码，在 API Level 11 之前的运行效果。

双击打开 AndroidManifest.xml 文件，将其中的代码：

<uses-sdk android:minSdkVersion="14" />

改为：

<uses-sdk android:minSdkVersion="9" />

再次运行 MenusDemo 实例，单击 Menu 按钮，得到的效果如图 2 所示。
 

图 2  API Level 11之前Menu按钮的运行效果

可见运行在早期的 API 之上的选项菜单效果要更好一些。为什么会出现这种现象呢？

其实在 Android SDK 3.0 之后，就不再鼓励直接使用选项菜单，而是将选项菜单和 ActionBar 结合使用。

ActionBar 又称活动栏，位于 Activity 的顶部，取代了原来标题的位置。

ActionBar 中包含很多 ActionItem，相当于选项菜单的菜单项。将选项菜单与 ActionBar 结合的方法很简单，只要在 XML 文件中添加一个 android:showAsAction="ifRoom" 属性即可。该属性表现如果标题栏有空间的话，就将相关的菜单项放置到 ActionBar 中。如果标题栏空间不足，未能放置到其中的菜单项仍然会以选项菜单的形式出现。

Context Menu

上下文菜单注册到 View 对象上后，用户长按该 View 对象可呼出上下文菜单。

上下文菜单悬浮于主界面之上，不支持图标显示和快捷键。其使用方法和选项菜单高度相似，只不过创建上下文菜单的方法为 onCreateContextMenu()，响应上下文菜单单击事件的方法为 onContextItemSelected()。

仍以工程 MenusDemo 为例，为 MenusActivity 的视图中的 TextView 对象添加一个具有两个菜单项的上下文菜单，运行效果如图 3 所示。
 

图 3  上下文菜单的运行结果

为 TextView 对象注册上下文菜单的代码如下：

textview = (TextView)findViewById(R.id.textview1);
registerForContextMenu(textview);

创建并处理上下文菜单单击事件的代码如下：

1. public boolean onContextItemSelected(MenuItem item) {
2. switch (item.getItemId()) {
3. case R.id.item1:
4. Log.i("menu", "item1!");
5. break;
6. case R.id.item2:
7. Log.i("menu", "item2!");
8. break;
9. case R.id.item3:
10. Log.i("menu", "item3!");
11. break;
12. case R.id.item4:
13. Log.i("menu", "item4!");
14. break;
15. case R.id.item5:
16. Log.i("menu", "item5!");
17. break;
18. case R.id.item6:
19. Log.i("menu", "item6!");
20. break;
21. case R.id.item7:
22. Log.i("menu", "item7!");
23. break;
24. default:
25. break;
26. }
27. return super.onContextItemSelected(item);
28. }
29.  
30. @Override
31. public void onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) {
32. menu.add(0, R.id.item1, 0, "item1");
33. menu.add(0, R.id.item2, 0, "item2");
34. menu.add(0, R.id.item3, 0, "item3");
35. menu.add(0, R.id.item4, 0, "item4");
36. menu.add(0, R.id.item5, 0, "item5");
37. menu.add(0, R.id.item6, 0, "item6");
38. menu.add(0, R.id.item7, 0, "item7");
39. super.onCreateContextMenu(menu, v, menuInfo);
40. }

SubMenu

子菜单可以被添加到其他菜单上，但是子菜单本身不能再有子菜单。

使用 addSubMenu() 方法为 MenusActivity 的选项菜单添加一个子菜单，运行效果如图 4 所示。
 

图 4  添加子菜单运行结果

创建并处理子菜单的代码为：

纯文本复制

1. package introduction.android.menusdemo;
2.  
3. import android.app.Activity;
4. import android.os.Bundle;
5. import android.support.v7.app.AppCompatActivity;
6. import android.view.Menu;
7. import android.view.MenuItem;
8. import android.view.SubMenu;
9. import android.widget.Toast;
10.  
11. public class MainActivity extends AppCompatActivity {
12. @Override
13. protected void onCreate(Bundle savedInstanceState) {
14. super.onCreate(savedInstanceState);
15. setContentView(R.layout.activity_main);
16.  
17. }
18.  
19. @Override
20. public boolean onCreateOptionsMenu(Menu menu) {
21. SubMenu file = menu.addSubMenu("文件");
22. SubMenu edit = menu.addSubMenu("编辑");
23. file.add(1, 1, 1, "新建");
24. file.add(1, 2, 1, "打开");
25. file.add(1, 3, 1, "保存");
26. file.setHeaderTitle("文件操作");
27. file.setHeaderIcon(R.drawable.icon1);
28. edit.add(2, 1, 1, "复制");
29. edit.add(2, 2, 1, "粘贴");
30. edit.add(2, 3, 1, "剪切");
31. edit.setHeaderTitle("文件操作");
32. edit.setHeaderIcon(R.drawable.icon1);
33. return true;
34.  
35. }
36.  
37. @Override
38. public boolean onOptionsItemSelected(MenuItem item) {
39. if (item.getGroupId() == 1) {
40. switch (item.getItemId()) {
41. case 1:
42. Toast.makeText(MainActivity.this, "点击了新建", Toast.LENGTH_SHORT).show();
43. break;
44. case 2:
45. Toast.makeText(MainActivity.this, "点击了打开", Toast.LENGTH_SHORT).show();
46. break;
47. case 3:
48. Toast.makeText(MainActivity.this, "点击了保存", Toast.LENGTH_SHORT).show();
49. break;
50. }
51. } else if (item.getGroupId() == 2) {
52. switch (item.getItemId()) {
53. case 1:
54. Toast.makeText(MainActivity.this, "点击了复制", Toast.LENGTH_SHORT).show();
55. break;
56. case 2:
57. Toast.makeText(MainActivity.this, "点击了粘贴", Toast.LENGTH_SHORT).show();
58. break;
59. case 3:
60. Toast.makeText(MainActivity.this, "点击了剪切", Toast.LENGTH_SHORT).show();
61. break;
62. }
63. }
64. return super.onOptionsItemSelected(item);
65. }
66. }