一、常用方法

  • onCreateOptionsMenu(Menu menu)
    每次Activity一创建就会执行,一般只执行一次,创建并保留Menu的实例;
//获取MenuInflater
    MenuInflater inflater = getMenuInflater();
//加载Menu资源
    inflater.inflate(R.menu.option_menu_normal,menu);
    
//此方法必须返回true,否则不予显示
    return true;
  • onPrepareOptionsMenu(Menu menu)
    每次menu被打开时,该方法就会执行一次,可用于对传入的旧Menu对象进行修改操作;
  • 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,避免截断菜单项的点击事件
    }
}
  • invalidateOptionsMenu()
    刷新menu里的选项里内容,它会调用onCreateOptionsMenu(Menu menu)方法
  • onCreateContextMenu()
    创建控件绑定的上下文菜单menu,根据方法里的View参数识别是哪个控件绑定
  • onContextItemSelected(MenuItem item)
    点击控件绑定的上下菜单menu的内容项
  • 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方法,实现菜单项的点击逻辑。
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.显示弹出菜单
        }
    });
}