Android 在活动中使用 Menu
•前行必备——创建 menu
首先,新建一个项目,选择 Empty Activity 选项,并命名为 Test Menu;
这样 Android Studio 自动为我们新建 MainActivity.java 和 activity_main.xml 文件;
进入 Test Menu 项目,将模式结构换成 Project 模式;
然后找到 app/scr/main/ 下的 res 文件夹;
有两种方式可以创建一个 menu;
方法一
如果创建一个新的项目,在 res 文件夹下默认没有 menu 这个文件夹;
我们的首要任务是新建一个 menu 文件夹,右击 res->New->Directory;
创建好 menu 文件夹后,右击menu->New->Menu resource file;
文件名输入 main,点击 OK 完成创建;
方法二
右击res->New->Android Resource File;
来到如下所示界面;
文件名输入 main,Resource type 选择 Menu 选项,点击 OK,就能实现和方法一一样的效果;
•渐入佳境——了解Menu
我们可以使用 <menu>、<item>、<group> 三种XML元素定义 Menu,下面简单介绍一下它们:
<menu>是菜单项的容器
- <menu>元素必须是该文件的根节点,并且能够包含一个或多个<item>和<group>元素
<item>是菜单项,用于定义MenuItem,可以嵌套<menu>元素,以便创建子菜单
<group>是<item>元素的不可见容器(可选)
- 可以使用它对菜单项进行分组,使一组菜单项共享可用性和可见性等属性。
其中,<item>是我们主要需要关注的元素,它的常见属性如下:
android:id:菜单项(MenuItem)的唯一标识
android:icon:菜单项的图标(可选)
android:title:菜单项的标题(必选)
android:showAsAction:指定菜单项的显示方式
- 常用的有ifRoom、never、always、withText
- 多个属性值之间可以使用|隔开
•步入主题——使用Menu
声明
我从网上下载了四张图片,放置在了 mipmap-hdpi 文件夹下:
依次命名为 icon_one , icon_two , icon_three , icon_four;
在我们新建的 main 中添加如下代码;
main.xml
<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto"> <item android:id="@+id/option_normal_1" android:icon="@mipmap/icon_one" android:title="普通菜单1" app:showAsAction="ifRoom"/> <item android:id="@+id/option_normal_2" android:icon="@mipmap/icon_two" android:title="普通菜单2" app:showAsAction="always"/> <item android:id="@+id/option_normal_3" android:icon="@mipmap/icon_three" android:title="普通菜单3" app:showAsAction="withText|always"/> <item android:id="@+id/option_normal_4" android:title="普通菜单4" android:icon="@mipmap/icon_four" app:showAsAction="never"/> </menu>可以看到,我们在XML文件中定义了四个普通的菜单项。
同时,每一个<item>都有一个独特的 app:showAsAction 属性。
我们需要知道,菜单栏中的菜单项会分为两个部分:
一部分可以直接在菜单栏中看见,我们可以称之为常驻菜单
另一部分会被集中收纳到溢出菜单中(就是菜单栏右侧的小点状图标)
一般情况下,常驻菜单项以图标形式显示(需要定义 android:icon 属性);
而溢出菜单项则以文字形式显示(通过 android:title 属性定义)。
showAsAction差异
app:showAsAction="always" :菜单项永远不会被收纳到溢出菜单中
- 因此在菜单项过多的情况下可能超出菜单栏的显示范围
app:showAsAction="ifRoom" :在空间足够时,菜单项会显示在菜单栏中,否则收纳入溢出菜单中。
app:showAsAction="withText" :无论菜单项是否定义了 android:icon 属性,都只会显示它的标题,而不会显示图标
- 使用这种方式的菜单项默认会被收纳入溢出菜单中
app:showAsAction="never" :菜单项永远只会出现在溢出菜单中
现在我们已经在 XML 文件中将 Menu 定义完毕了,接下来还需要在Java代码中进行加载;
MainActivity.java
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.main,menu); return true; } }在该代码中重写了 onCreateOptionsMenu(Menu menu) 方法;
重写方法时可以使用 Ctrl+O 快捷键,然后检索 onCreateOptionsMenu:
在该方法中通过 getMenuInflater() 方法得到 MenuInflater 对象;
再调用它的 inflate() 方法就可以给当前活动创建菜单了;
inflate() 方法接受两个参数:
第一个参数用于指定我们通过哪一个资源文件来创建菜单
- 这里传入 R.menu.main
第二个参数用于指定我们的菜单项将添加到哪一个 Menu 对象中
- 这里直接使用 onCreateOptionsMenu() 方法传入的 menu 参数
然后给这个方法返回 true,表示允许创建的菜单显示出来,如果返回 false,创建的菜单将无法显示;
运行效果
为 Menu 设置点击事件
修改 MainActivity.java 中的代码;
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.main,menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()){ case R.id.option_normal_1: return true; case R.id.option_normal_2: return true; case R.id.option_normal_3: return true; case R.id.option_normal_4: return true; default: return super.onOptionsItemSelected(item); } } }在 onOptionsItemSelected(MenuItem item) 方法中,我们实现了菜单项的点击监听。
可以看见,这里是通过 MenuItem 的 id 进行区分的,对应着XML文件中<item>的id属性。
每次处理完点击事件后,记得要返回true,对系统而言这次点击事情才算是真正结束了。
此外,在 default 分支下,推荐调用父类的默认实现,即 super.onOptionsItemSelected(item) ;
避免在多个 Activity 使用公有父类的情况下菜单项点击事件无法触发
•声明
有关 Menu 的其他用法,请参考【Android Menu用法全面讲解】;