菜单是许多应用类型中常见的界面组件。为了提供熟悉且一致的用户体验，您应使用 Menu API 呈现 Activity 中的用户操作和其他选项。

从 Android 3.0（API 级别 11）开始，Android 设备不必再提供一个专用“菜单”按钮。随着这种改变，Android 应用应摆脱对包含 6 个菜单项的传统菜单面板的依赖，改为提供一个应用栏来呈现常见的用户操作。

尽管某些菜单项的设计和用户体验已发生改变，但定义一系列操作和选项时所使用的语义仍是以 Menu API 为基础。本指南将介绍所有 Android 版本中三种基本菜单或操作呈现效果的创建方法：

请参阅创建选项菜单部分。

关联操作模式在屏幕顶部栏显示影响所选内容的操作项，并允许用户选择多项内容。

请参阅创建上下文菜单部分。

请参阅创建弹出式菜单部分。

对于所有菜单类型，Android 提供标准的 XML 格式来定义菜单项。您应在 XML 菜单资源中定义菜单及其所有菜单项，而非在 Activity 的代码中构建菜单。然后，您可以在 Activity 或 Fragment 中膨胀菜单资源（将其作为 Menu 对象加载）。

使用菜单资源是一种很好的做法，原因如下：

如需定义菜单，请在项目的 res/menu/ 目录内创建 XML 文件，并使用以下元素构建菜单：

以下是名为 game_menu.xml 的菜单示例：

元素支持多个属性，您可使用这些属性定义菜单项的外观和行为。上述菜单中的菜单项包括以下属性：

这些是您应使用的最重要的属性，但还有许多其他可用属性。如需了解受到支持的所有属性，请参阅菜单资源文档。

您可以添加 元素作为 的子元素，从而向任何菜单中的菜单项添加子菜单。当应用具有大量可按主题进行组织的功能时，子菜单非常有用，PC 应用菜单栏中的菜单项（“文件”、“编辑”、“视图”等）就属于这种情况。例如：

如需在 Activity 中使用菜单，您需要使用 MenuInflater.inflate() 膨胀菜单资源（将 XML 资源转换为可编程对象）。在以下几部分，您将了解如何膨胀每种菜单类型的菜单。

图 1. 浏览器中的选项菜单。

在选项菜单中，您应当包含与当前 Activity 上下文相关的操作和其他选项，如“搜索”、“撰写电子邮件”和“设置”。

选项菜单中的菜单项在屏幕上的显示位置取决于您开发的应用所适用的 Android 版本：

如需详细了解操作项和其他应用栏行为，请参阅添加应用栏培训课程。

图 2. Google 表格应用，显示了包括操作溢出菜单按钮在内的多个按钮。

您可以通过 Activity 子类或 Fragment 子类为选项菜单声明菜单项。如果您的 Activity 和 Fragment 均为选项菜单声明了菜单项，这些菜单项会合并到界面中。系统会先显示 Activity 的菜单项，然后按每个 Fragment 添加至 Activity 的顺序显示各 Fragment 的菜单项。如有必要，您可以使用 android:orderInCategory 属性，对每个需移动的 中的菜单项重新排序。

如需为 Activity 指定选项菜单，请替换 onCreateOptionsMenu()（Fragment 会提供自己的 onCreateOptionsMenu() 回调）。通过此方法，您可以将菜单资源（使用 XML 定义）膨胀到回调所提供的 Menu 中。例如：

此外，您还可以使用 add() 添加菜单项，并使用 findItem() 检索菜单项，以便使用 MenuItem API 修改其属性。

如果您开发的应用适用于 Android 2.3.x 及更低版本，当用户首次打开选项菜单时，系统会调用 onCreateOptionsMenu() 来创建该菜单。如果您开发的应用适用于 Android 3.0 及更高版本，系统会在启动 Activity 时调用 onCreateOptionsMenu()，以便向应用栏显示菜单项。

当用户从选项菜单中选择菜单项（包括应用栏中的操作项）时，系统会调用 Activity 的 onOptionsItemSelected() 方法。此方法会传递所选的 MenuItem。您可以通过调用 getItemId() 方法来识别菜单项，该方法会返回菜单项的唯一 ID（由菜单资源中的 android:id 属性定义，或通过提供给 add() 方法的整型数定义）。您可以将此 ID 与已知的菜单项进行匹配，以执行相应的操作。例如：

成功处理菜单项后，系统会返回 true。如果未处理菜单项，您应调用 onOptionsItemSelected() 的父类实现（默认实现会返回 false）。

如果 Activity 包括 Fragment，系统会先为 Activity 后为每个 Fragment（按照每个 Fragment 的添加顺序）调用 onOptionsItemSelected()，直到有一个返回结果为 true 或所有 Fragment 均调用完毕为止。

提示：Android 3.0 新增一项功能，可让您在 XML 中使用 android:onClick 属性为菜单项定义点击行为。该属性的值必须是使用该菜单的 Activity 所定义的方法的名称。该方法必须是公用的，且接受单个 MenuItem 参数；当系统调用此方法时，它会传递所选的菜单项。如需了解详情并查看示例，请参阅菜单资源文档。

提示：如果应用包含多个 Activity，且其中某些 Activity 提供相同的选项菜单，可以考虑创建一个仅实现 onCreateOptionsMenu() 和 onOptionsItemSelected() 方法的 Activity。然后，为每个应共用相同选项菜单的 Activity 扩展此类。通过这种方式，您可以管理一个用于处理菜单操作的代码集，并且每个后代类均会继承菜单行为。若要将菜单项添加到其中某个后代 Activity，请替换该 Activity 中的 onCreateOptionsMenu()。调用 super.onCreateOptionsMenu(menu)，以便创建原始菜单项，然后使用 menu.add() 添加新菜单项。此外，您还可替换各个菜单项的父类行为。

系统调用 onCreateOptionsMenu() 后，会保留您填充的 Menu 实例。除非菜单由于某些原因而失效，否则系统不会再次调用 onCreateOptionsMenu()。但是，您只应使用 onCreateOptionsMenu() 来创建初始菜单状态，而不应使用它在 Activity 生命周期中执行任何更改。

如需根据在 Activity 生命周期中发生的事件修改选项菜单，可通过 onPrepareOptionsMenu() 方法执行此操作。此方法向您传递 Menu 对象（因为该对象目前存在），以便您能够对其进行修改，如添加、移除或停用菜单项。（Fragment 也提供 onPrepareOptionsMenu() 回调。）

在 Android 2.3.x 及更低版本中，每当用户打开选项菜单时（按“菜单”按钮），系统均会调用 onPrepareOptionsMenu()。

在 Android 3.0 及更高版本中，当菜单项显示在应用栏中时，系统会将选项菜单视为始终处于打开状态。发生事件时，如果您要执行菜单更新，必须调用 invalidateOptionsMenu() 来请求系统调用 onPrepareOptionsMenu()。

注意：切勿根据目前处于焦点的 View 更改选项菜单中的菜单项。处于轻触模式（用户未使用轨迹球或方向键）时，视图无法形成焦点，因此切勿根据焦点修改选项菜单中的菜单项。若要为 View 提供上下文相关的菜单项，请使用 上下文菜单。

图 3. 悬浮上下文菜单（左）和关联操作栏（右）的屏幕截图。

上下文菜单提供许多操作，这些操作会影响界面中的特定菜单项或上下文框架。您可以为任何视图提供上下文菜单，但这些菜单通常用于 ListView、GridView 或用户可直接操作其中每个菜单项的其他视图集合中的菜单项。

提供关联操作的方式有两种：

注意：关联操作模式可用于 Android 3.0（API 级别 11）及更高版本，是显示关联操作（如果可用）的首选方法。如果应用支持低于 3.0 版本的系统，那么您应在这些设备上回退到悬浮上下文菜单。

如需提供悬浮上下文菜单，请执行以下操作：

如果 Activity 使用 ListView 或 GridView 且您希望每个菜单项均提供相同的上下文菜单，请通过将 ListView 或 GridView 传递给 registerForContextMenu()，为上下文菜单注册所有菜单项。

当注册后的视图收到长按事件时，系统会调用您的 onCreateContextMenu() 方法。在此方法中，您通常可通过膨胀菜单资源来定义菜单项。例如：

MenuInflater 让您可以通过菜单资源膨胀上下文菜单。回调方法参数包括用户所选的 View，以及提供有关所选菜单项附加信息的 ContextMenu.ContextMenuInfo 对象。如果 Activity 有多个视图，每个视图提供的上下文菜单不同，您可以使用这些参数确定要膨胀的上下文菜单。

当用户选择菜单项时，系统会调用此方法，以便您能够执行相应的操作。例如：

getItemId() 方法会查询所选菜单项的 ID，您应在 XML 中使用 android:id 属性将此 ID 分配给每个菜单项（如使用 XML 定义菜单部分所示）。

成功处理菜单项后，系统会返回 true。如果未处理菜单项，您应将菜单项传递给父类实现。如果 Activity 包括 Fragment，那么该 Activity 会先收到此回调。通过在未处理的情况下调用父类，系统会（按照每个 Fragment 的添加顺序）将事件逐一传递给每个 Fragment 中相应的回调方法，直到返回 true 或 false 为止。（Activity 和 android.app.Fragment 的默认实现会返回 false，因此您始终应在未处理的情况下调用父类。）

关联操作模式是 ActionMode 的一种系统实现，它将用户互动的重点放在执行关联操作上。当用户通过选择菜单项启用此模式时，屏幕顶部会出现“关联操作栏”，显示用户可对当前所选菜单项执行的操作。启用此模式后，用户可以选择多个菜单项（若您允许）、取消选择菜单项，以及继续在 Activity 内导航（在您允许的最大范围内）。当用户取消选择所有菜单项、按“返回”按钮或选择操作栏左侧的“完成”操作时，该操作模式将会停用，而关联操作栏也会消失。

注意：关联操作栏不一定与应用栏相关联。尽管表面上看来关联操作栏取代了应用栏的位置，但事实上二者独立运行。

对于提供关联操作的视图，当出现以下两个事件（或之一）时，您通常应调用关联操作模式：

应用如何调用关联操作模式以及如何定义每个操作的行为取决于您的设计。设计基本上分为两种：

下面几部分介绍了每种场景所需的设置。

如果只想在用户选择特定视图时调用关联操作模式，您应：

例如：

请注意，这些事件回调与选项菜单的回调几乎完全相同，只是其中每个回调还会传递与事件相关联的 ActionMode 对象。您可以使用 ActionMode API 对 CAB 进行各种更改，例如：使用 setTitle() 和 setSubtitle() 修改标题和副标题（这有助于指示需选择多少个菜单项）。

另请注意，当系统销毁该操作模式时，上述示例会将 actionMode 变量设置为 null。在下一步中，您将了解如何初始化该变量，以及保存 Activity 或 Fragment 中的成员变量有何作用。

当您调用 startActionMode() 时，系统会返回已创建的 ActionMode。通过将其保存在成员变量中，您可以通过更改关联操作栏来响应其他事件。在上述示例中，ActionMode 用于在启动该操作模式前检查成员是否为 null，从而确保当 ActionMode 实例已激活时不再重建该实例。

如果您在 ListView 或 GridView（或 AbsListView 的其他扩展）中有一组菜单项，且希望允许用户执行批处理操作，您应：

例如：

大功告成。现在，当用户通过长按选择菜单项时，系统会调用 onCreateActionMode() 方法，并显示包含指定操作的关联操作栏。当关联操作栏可见时，用户可以选择其他菜单项。

在某些情况下，如果关联操作提供常用的操作项，您可能还需要通过添加复选框或类似的界面元素来支持用户选择菜单项，因为他们可能未发现长按行为。当用户选中该复选框时，您可以使用 setItemChecked() 将相应的列表项设置为选中状态，从而调用关联操作模式。

图 4. Gmail 应用中的弹出式菜单，锚定到右上角的溢出按钮。

PopupMenu 是锚定在 View 中的模态菜单。如果空间足够，它会显示在锚定视图下方，否则显示在其上方。它适用于：

注意：这与上下文菜单不同，后者通常用于影响所选内容的操作。对于影响所选内容的操作，请使用关联操作模式或悬浮上下文菜单。

注意：PopupMenu 在 API 级别 11 及更高版本中可用。

如果使用 XML 定义菜单，弹出式菜单的显示方式如下：

例如，以下是一个使用 android:onClick 属性显示弹出式菜单的按钮：

稍后，Activity 可按如下方式显示弹出式菜单：

在 API 级别 14 及更高版本中，您可以将两行合并在一起，使用 PopupMenu.inflate() 膨胀菜单。

当用户选择菜单项或轻触菜单以外的区域时，系统会关闭此菜单。您可使用 PopupMenu.OnDismissListener 监听关闭事件。

如需在用户选择菜单项时执行操作，您必须实现 PopupMenu.OnMenuItemClickListener 接口，并通过调用 setOnMenuItemclickListener() 将其注册到 PopupMenu。当用户选择菜单项时，系统会在您的接口中调用 onMenuItemClick() 回调。

例如：

菜单组是指一系列具有某些共同特征的菜单项。通过菜单组，您可以：

通过将 元素嵌套在菜单资源中的 元素内，或者通过使用 add() 方法指定组 ID，您可以创建组。

以下是包含组的菜单资源示例：

组中的菜单项出现在与第一个菜单项相同的级别，即：菜单中的全部三个菜单项均为同级。但是，您可以通过引用组 ID 并使用上面列出的方法，修改组中两个菜单项的特征。此外，系统也绝不会将已分组的菜单项分开。例如，如果为每个菜单项声明 android:showAsAction="ifRoom"，它们就会同时显示在操作栏或操作溢出菜单中。

图 5. 含可选中菜单项的子菜单的屏幕截图。

菜单非常适合用作启用/停用选项的接口，既可针对独立选项使用复选框，也可针对互斥选项组使用单选按钮。图 5 展示了可使用单选按钮选中菜单项的子菜单。

注意：图标菜单（在选项菜单中）的菜单项无法显示复选框或单选按钮。如果您选择使图标菜单中的菜单项可选中，就必须在选中状态每次发生变化时交换图标和/或文本，从而手动指出该状态。

您可以在 元素中使用 android:checkable 属性为各个菜单项定义可选中的行为，或者在 元素中使用 android:checkableBehavior 属性为整个组定义可选中的行为。例如，此菜单组中的所有菜单项都可以通过单选按钮选中：

android:checkableBehavior 属性接受以下任一选项：

您可以在 元素中使用 android:checked 属性将默认的选中状态应用于菜单项，并可使用 setChecked() 方法在代码中更改此默认状态。

选择可选中菜单项后，系统会调用所选菜单项的相应回调方法（例如 onOptionsItemSelected()）。此时，您必须设置复选框的状态，因为复选框或单选按钮不会自动更改其状态。您可以使用 isChecked() 查询菜单项的当前状态（正如用户选择该菜单项之前一样），然后使用 setChecked() 设置选中状态。例如：

如果未通过这种方式设置选中状态，那么菜单项（复选框或单选按钮）的可见状态不会在用户选择它时发生变化。如果设置了该状态，Activity 会保留菜单项的选中状态。如此一来，当用户稍后打开菜单时，您设置的选中状态便会处于可见状态。

注意：可选中菜单项的使用往往因会话而异，且在应用销毁后不予保存。如果您想为用户保存某些应用设置，应使用共享首选项存储数据。

有时，您会希望菜单项使用 Intent 启动 Activity（无论该 Activity 是在您的应用中还是其他应用中）。如果您知道自己要使用的 Intent，且拥有启动该 Intent 的特定菜单项，您可以在相应的 on-item-selected 回调方法（例如，onOptionsItemSelected() 回调）期间使用 startActivity() 执行该 Intent。

但是，如果不确定用户的设备是否包含可处理 Intent 的应用，添加调用 Intent 的菜单项就有可能导致该菜单项无法正常工作，因为 Intent 可能无法解析为 Activity。为解决此问题，当 Android 在设备上找到可处理您的 Intent 的 Activity 时，其会允许您向菜单动态添加菜单项。

如要根据接受 Intent 的可用 Activity 添加菜单项，请执行以下操作：

如果未安装可处理该 Intent 的应用，系统不会添加任何菜单项。

注意：CATEGORY_SELECTED_ALTERNATIVE 用于处理屏幕上当前所选的元素。因此，此类别只适用于在 onCreateContextMenu() 中创建菜单的情况。

例如：

但凡发现 Activity 提供的 Intent 过滤器与定义的 Intent 匹配，系统就会为相应 Activity 添加菜单项，并使用 Intent 过滤器 android:label 中的值作为菜单项标题，使用应用图标作为菜单项图标。addIntentOptions() 方法会返回已添加的菜单项数量。

注意：调用 addIntentOptions() 时，该方法会使用第一个参数中指定的菜单组替换所有菜单项。

您还可以为其他应用提供您的 Activity 服务，以便其他应用的菜单中能加入您的应用（与上述作用相反）。

如要在其他应用菜单中加入您的应用，您需按常规方式定义 Intent 过滤器，但请确保为 Intent 过滤器类别添加 CATEGORY_ALTERNATIVE 和/或 CATEGORY_SELECTED_ALTERNATIVE 值。例如：

请仔细阅读 Intent 和 Intent 过滤器文档中有关编写 intent 过滤器的更多内容。