何为选项菜单?
选项菜单是某个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:欢迎留言交流,共同进步。