一、常用方法
java onCreateOptionsMenu(Menu menu)
每次Activity一创建就会执行,一般只执行一次,创建并保留Menu的实例;
//获取MenuInflater
MenuInflater inflater = getMenuInflater();
//加载Menu资源
inflater.inflate(R.menu.option_menu_normal,menu);
//此方法必须返回true,否则不予显示
return true;
java onPrepareOptionsMenu(Menu menu)
每次menu被打开时,该方法就会执行一次,可用于对传入的旧Menu对象进行修改操作;
java onOptionsItemSelected(MenuItem item)
每次menu菜单项被点击时,该方法就会执行一次;
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()){
case R.id.option_normal_1:
return true; //返回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); //不返回true,避免截断菜单项的点击事件
}
}
java invalidateOptionsMenu()
刷新menu里的选项里内容,它会调用onCreateOptionsMenu(Menu menu)方法
java onCreateContextMenu()
创建控件绑定的上下文菜单menu,根据方法里的View参数识别是哪个控件绑定
java onContextItemSelected(MenuItem item)
点击控件绑定的上下菜单menu的内容项
java invalidateOptionsMenu()
通知系统刷新Menu,之后,onPrepareOptionsMenu会被调用
二、使用XML定义Menu
理论上而言,使用XML和Java代码都可以创建Menu。但是在实际开发中,往往通过XML文件定义Menu,这样做有以下几个好处:
- 使用XML可以获得更清晰的菜单结构
- 将菜单内容与应用的逻辑代码分离
- 可以使用应用资源框架,为不同的平台版本、屏幕尺寸创建最合适的菜单(如对drawable、string等系统资源的使用)
要定义Menu,我们首先需要在res文件夹下新建menu文件夹,它将用于存储与Menu相关的所有XML文件。
我们可以使用
、、三种XML元素定义Menu,下面简单介绍一下它们:
- 是菜单项的容器。
- 元素必须是该文件的根节点,并且能够包含一个或多个和元素。
- 是菜单项
- 用于定义MenuItem,可以嵌套元素,以便创建子菜单。
- 是元素的不可见容器(可选)。
- 可以使用它对菜单项进行分组,使一组菜单项共享可用性和可见性等属性。
其中,是我们主要需要关注的元素,它的常见属性如下:
android:id:菜单项(MenuItem)的唯一标识
android:icon:菜单项的图标(可选)
android:title:菜单项的标题(必选)
android:showAsAction:指定菜单项的显示方式。常用的有ifRoom、never、always、withText,多个属性值之间可以使用|隔开
名称 | 效果 |
---|---|
always | 菜单项永远不会被收纳到溢出菜单中,因此在菜单项过多的情况下可能超出菜单栏的显示范围。 |
ifRoom | 在空间足够时,菜单项会显示在菜单栏中,否则收纳入溢出菜单中。 |
withText | 无论菜单项是否定义了icon属性,都只会显示它的标题,而不会显示图标。使用这种方式的菜单项默认会被收纳入溢出菜单中。 |
never | 菜单项永远只会出现在溢出菜单中。 |
- 在碎片中调用菜单时,要在
Fragment的onCreate()
方法中调用setHasOptionsMenu(true)
方法使之显示出来。
三、三种菜单类型
1、选项菜单
选项菜单是一个应用的主菜单项,用于放置对应用产生全局影响的操作,如搜索/设置
包含多级子项的XML代码,通过onOptionsItemSelected(MenuItem item)返回值为true来截断
//包含多级子项的XML代码
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item android:id="@+id/option_sub_file"
android:title="文件"
app:showAsAction="ifRoom">
<menu>
<item android:id="@+id/file_new"
android:title="新建"/>
<item android:id="@+id/file_save"
android:title="保存"/>
<item android:id="@+id/file_more"
android:title="更多">
<menu>
<item android:id="@+id/file_more_1"
android:title="更多1"/>
<item android:id="@+id/file_more_2"
android:title="更多2"/>
<item android:id="@+id/file_more_more"
android:title="更多更多">
<menu>
<item android:id="@+id/file_more_more_1"
android:title="更多更多1"/>
<item android:id="@+id/file_more_more_2"
android:title="更多更多2"/>
</menu>
</item>
</menu>
</item>
</menu>
</item>
</menu>
//Java代码
@Override
public boolean onCreateOptionsMenu(Menu menu) {
MenuInflater inflater=getMenuInflater();
inflater.inflate(R.menu.option_menu_normal,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);
}
}
2、上下文菜单
- 上下文菜单是用户长按某一元素时出现的浮动菜单。它提供的操作将影响所选内容,主要应用于列表中的每一项元素(如长按列表项弹出删除对话框)。上下文操作模式将在屏幕顶部栏(菜单栏)显示影响所选内容的操作选项,并允许用户选择多项,一般用于对列表类型的数据进行批量操作。
- 要提供浮动上下文菜单,可以参照以下步骤:
- 在Activity或Fragment中调用
registerForContextMenu(View v)
方法,注册需要和上下文菜单关联的View。如果将ListView或GridView作为参数传入,那么每个列表项将会有相同的浮动上下文菜单。 - 在Activity或Fragment中重写
onCreateContextMenu
方法,加载Menu资源。 - 在Activity或Fragment中重写
onContextItemSelected
方法,实现菜单项的点击逻辑。
- 在Activity或Fragment中调用
3、弹出菜单(不需要onCreateOptionsMenu方法)
- 弹出菜单以垂直列表形式显示一系列操作选项,一般由某一控件触发,弹出菜单将显示在对应控件的上方或下方。它适用于提供与特定内容相关的大量操作。
- 可以将弹出菜单的使用拆分为以下四个步骤:
- 实例化PopupMenu,它的构造方法需要两个参数,分别为Context以及PopupMenu依赖的View对象。
- 使用MenuInflater将Menu资源加载到
PopupMenu.getMenu()
返回的Menu对象中。 - 调用
setOnMenuItemClickListener
方法为PopupMenu设置点击监听器。 - 调用
PopupMenu.show()
将弹出菜单显示出来。
//XML文件代码
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/popup_add"
android:title="添加"/>
<item android:id="@+id/popup_delete"
android:title="删除"/>
<item android:id="@+id/popup_more"
android:title="更多"/>
</menu>
//Java文件代码
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_popup_menu);
findViewById(R.id.popup_menu_view).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
PopupMenu popupMenu=new PopupMenu(PopupMenuActivity.this,view);//1.实例化PopupMenu
getMenuInflater().inflate(R.menu.popup_menu,popupMenu.getMenu());//2.加载Menu资源
//3.为弹出菜单设置点击监听
popupMenu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
@Override
public boolean onMenuItemClick(MenuItem item) {
switch (item.getItemId()){
case R.id.popup_add:
Toast.makeText(PopupMenuActivity.this,"添加",Toast.LENGTH_SHORT).show();
return true;
case R.id.popup_delete:
Toast.makeText(PopupMenuActivity.this,"删除",Toast.LENGTH_SHORT).show();
return true;
case R.id.popup_more:
Toast.makeText(PopupMenuActivity.this,"更多",Toast.LENGTH_SHORT).show();
return true;
default:
return false;
}
}
});
popupMenu.show();//4.显示弹出菜单
}
});
}
另外参考大佬:https://blog.csdn.net/wangmx1993328/article/details/82781469