使用 XML 定义选项菜单

何为选项菜单？

选项菜单是某个Activity的主菜单项，供您放置对应用产生全局影响的操作，如“搜索”、“撰写电子邮件”和设置。选项菜单中的项目在屏幕上的显示位置取决于您开发应用所使用的 Android 版本：

• 如果您开发的应用适用于 Android 2.3.x （API 级别10）或更低版本，选项菜单的内容会出现在屏幕底部如下图所示，且当菜单项超过6个时，则会讲第六项和其余项目放入溢出菜单（即图中的 More 菜单项）中。
  

• 如果您开发的应用适用于 Android 3.0 （API 级别 11）及更高版本，选项菜单的内容将出现在应用栏中如下图所示。默认情况下，系统会将所有的菜单项放入操作溢出菜单（即图中标号为3的菜单项）中。
  

创建menu资源文件

首先我在 app/src/mian/res/menu/ 目录下创建一个 my_menu.xml 文件

内容如下：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item
        android:id="@+id/item1"
        android:icon="@mipmap/ic_launcher"
        android:title="item1"/>

    <item
        android:id="@+id/item2"
        android:icon="@mipmap/ic_launcher"
        android:title="item2"/>

    <group
        android:id="@+id/group"
        android:checkableBehavior="single">
        <item
            android:id="@+id/group_item1"
            android:icon="@mipmap/ic_launcher"
            android:title="group_item1"/>

        <item
            android:id="@+id/group_item2"
            android:icon="@mipmap/ic_launcher"
            android:title="group_item2"/>
    </group>

    <item
        android:id="@+id/submenu"
        android:title="submenu_title">
        <menu>
            <item
                android:id="@+id/submenu_item1"
                android:title="submenu_item1"/>
        </menu>
    </item>

</menu>

从代码中我们可以看出，菜单资源文件以<menu>为根节点，使用<item>元素来定义菜单项。同时，我们也可以选择使用<group>元素来定义一个组，来对组内的菜单项的一些特性进行统一的修改，比如是否可见。最后，可以看到我们以在<item>元素中嵌套<menu>元素的方式来创建子菜单。

<item>元素的常用属性：

• android:id 为菜单项指定一个唯一标识
• android:title 指定菜单项的标题
• android:icon 指定菜单项的图标
• android:showAsAction 指定菜单项作为操作项目显示在应用栏的时间和方式

<group>元素的常用属性

• android:id 为改组菜单指定一个唯一标识
• android:checkableBehavior 指定改组菜单的选择行为
• android:visible 指定改组菜单是否可见
• android:enable 指定改组菜单是否可用

更详细的介绍请参考API文档Menu部分。

加载menu资源文件

通过重写 onCreateOptionsMenu() 方法，来为 Activity 指定选项菜单。

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.my_menu, menu);
        return true;
    }
}

运行效果：

处理点击事件

当我们从选项菜单中选择项目时，系统将调用 Activity 的 onOptionsItemSelected() 方法。 此方法将传递所选的 MenuItem，可以通过调用 getItemId() 方法来识别项目，该方法将返回菜单项的唯一 ID（由菜单资源中的 android:id 属性定义）。 我们可以将此 ID 与已知的菜单项匹配，以执行适当的操作。例如：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.my_menu, menu);
        return true;
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        switch (item.getItemId()) {
            case R.id.group_item1:
                item.setChecked(true);
                return true;
            case R.id.group_item2:
                item.setChecked(true);
                return true;
            default:
                Toast.makeText(this, "selected " + item.getTitle(), Toast.LENGTH_SHORT).show();
                return super.onOptionsItemSelected(item);
        }
    }
}

运行效果：

总结

本文主要初步的介绍了如何使用 XML 定义选项菜单，定义其他类型菜单的方法类似。更深入的了解和使用菜单请参考Android官方教程。关于即便设置showAsAction=”always”，items仍然在overflow中显示的问题，请参考这篇文章。

ps:欢迎留言交流，共同进步。