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

蔚落 2021-12-09 23:23 680阅读 0赞

菜单是人机交互的重要接口，在 [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 所示。

![“Menu”按钮运行效果][Menu]  
图 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 所示。

![API Level 11之前Menu按钮的运行效果][API Level 11_Menu]  
图 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 所示。

![上下文菜单的运行结果][5-1Z40910254a20.gif]  
图 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 所示。

![添加子菜单运行结果][5-1Z40910403RQ.PNG]  
图 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. \}

[Android]: http://c.biancheng.net/android/
[Menu]: /images/20211209/8e812c48de3a4bdc9e27164c80a36953.png
[API Level 11_Menu]: /images/20211209/7acc979030604616b1f7413a6e626d0d.png
[5-1Z40910254a20.gif]: /images/20211209/af3ae5a25cb541289b58dfb1cd1fc3e3.png
[5-1Z40910403RQ.PNG]: /images/20211209/724ad048da1445c5b282e1111cb7b5de.png