前言

今天看了pro android 3中menu这一章，对Android的整个menu体系有了进一步的了解，故整理下笔记与大家分享。

PS：强烈推荐《Pro Android 3》，是我至今为止看到的最好的一本android书，中文版出到《精通Android 2》。

理解Android的菜单

菜单是许多应用程序不可或缺的一部分，Android中更是如此，所有搭载Android系统的手机甚至都要有一个"Menu"键，由此可见菜单在Android程序中的特殊性。Android SDK提供的菜单有如下几种：

  1. 选项菜单：最常规的菜单，android中把它叫做option menu
  2. 子菜单：android中点击子菜单将弹出悬浮窗口显示子菜单项。子菜单不支持嵌套，即子菜单中不能再包括其他子菜单。
  3. 上下文菜单：android中长按视图控件后出现的菜单，windows点击右键弹出的菜单即上下文菜单
  4. 图标菜单：这个比较简单，就是带icon的菜单项，需要注意的是子菜单项、上下文菜单项、扩展菜单项均无法显示图标。
  5. 选择菜单(alternative menu)：用的比较少，以后单独介绍，本文先跳过（其实是我还没弄明白啦o(≧v≦)o~~）
  6. 扩展菜单：选项菜单最多只能显示6个菜单项，超过6个时，第6个菜单项会被系统替换为一个叫“更多”的子菜单，原来显示不下的菜单项都作为“更多”菜单的子菜单项。如下图：

　　理解Android的菜单_第1张图片 　　理解Android的菜单_第2张图片

　　　　　　　　第6个菜单项自动变为“更多”　　　　　　　　　　　　　　点击“更多”显示其他菜单项

Android3.0又引入了一个叫action bar的东西，本文不做讲解，大家自己google。

android.view.Menu接口代表一个菜单，android用它来管理各种菜单项。注意我们一般不自己创建menu，因为每个Activity默认都自带了一个，我们要做的是为它加菜单项和响应菜单项的点击事件。android.view.MenuItem代表每个菜单项，android.view.SubMenu代表子菜单。其三者的关系可以用下图来表示

　　理解Android的菜单_第3张图片

上面说过，每个activity包含一个菜单，一个菜单又能包含多个菜单项和多个子菜单，子菜单其实也是菜单（因为它实现了Menu接口），因此子菜单也可以包含多个菜单项。SubMenu继承了Menu的addSubMenu()方法，但调用时会抛出运行时错误。OnCreateOptionsMenu()和OnOptionsMenuSelected()是activity中提供了两个回调方法，用于创建菜单项和响应菜单项的点击。

创建options menu

之前提到，Android的activity已经为我们提前创建好了android.view.Menu对象，并提供了回调方法onCreateOptionsMenu(Menumenu)供我们初始化菜单的内容。该方法只会在选项菜单第一次显示的时候被执行，如果你需要动态改变选项菜单的内容，请使用onPrepareOptionsMenu(Menu)。

复制代码 复制代码 
@Overridepublicboolean onCreateOptionsMenu(Menu menu) {    // 调用父类方法来加入系统菜单    // 虽然目前android还没有系统菜单，但是为了兼容到以后的版本，最好加上super.onCreateOptionsMenu(menu);       // 添加菜单项（多种方式）    // 1.直接指定标题    menu.add("菜单项1");    // 2.通过资源指定标题    menu.add(R.string.menuitem2);    // 3.显示指定菜单项的组号、ID、排序号、标题    menu.add(            1,            //组号            Menu.FIRST, //唯一的ID号            Menu.FIRST, //排序号"菜单项3"); //标题       // 如果希望显示菜单，请返回truereturntrue;}
复制代码 复制代码


上面的代码演示了添加菜单项的3种方法，下面解释下第三种方法add(int groupId, int itemId, int order,CharSequencetitle)。其中，第一个参数是组号，android中你可以给菜单分组，以便快速地操作同一组的菜单。第二个参数指定每个菜单项的唯一ID号，你可以自己指定，也可以让系统来自动分配，在响应菜单时你需要通过ID号来判断哪个菜单被点击了。因此常规的做法是定义一些ID常量，但在android中有更好的方法，就是通过资源文件来引用，这个之后介绍。第三个参数代表菜单项显示顺序的编号，编号小的显示在前面。

给菜单项分组

复制代码 复制代码 
@Overridepublicboolean onCreateOptionsMenu(Menu menu) {    super.onCreateOptionsMenu(menu);    // 添加4个菜单项，分成2组int group1 =1;    int gourp2 =2;    menu.add(group1, 1, 1, "item 1");    menu.add(group1, 2, 2, "item 2");    menu.add(gourp2, 3, 3, "item 3");    menu.add(gourp2, 4, 4, "item 4");    // 显示菜单returntrue;}
复制代码 复制代码

你可以向上面这样给菜单项分组，分组之后就能使用menu中提供的方法对组进行操作了，如下：

menu.removeGroup(group1);    //删除一组菜单menu.setGroupVisible(gourp2, visible);    //设置一组菜单是否可见menu.setGroupEnabled(gourp2, enabled);    //设置一组菜单是否可点menu.setGroupCheckable(gourp2, checkable, exclusive);    //设置一组菜单的勾选情况

响应菜单项

android提供了多种响应菜单项的方式，下面一一介绍

1、通过onOptionsItemSelected方法

使用的最多方法是重写activity类的onOptionsItemSelected(MenuItem)回调方法，每当有菜单项被点击时，android就会调用该方法，并传入被点击菜单项。

复制代码 复制代码 
@Overridepublicboolean onOptionsItemSelected(MenuItem item) {    switch (item.getItemId()) {    //响应每个菜单项(通过菜单项的ID)case1:        // do something herebreak;    case2:        // do something herebreak;    case3:        // do something herebreak;    case4:        // do something herebreak;    default:        //对没有处理的事件，交给父类来处理returnsuper.onOptionsItemSelected(item);    }    //返回true表示处理完菜单项的事件，不需要将该事件继续传播下去了returntrue;}
复制代码 复制代码

以上代码可作为使用onOptionsItemSelected方法响应菜单的模板来使用，这里为了方便起见将菜单ID硬编码在程序里，你可以使用常量或资源ID来使代码更健壮。

2.使用监听器

虽然第一种方法是推荐使用的方法，android还是提供了类似java swing的监听器方式来响应菜单。使用监听器的方式分为两步:

复制代码 复制代码 
//第一步：创建监听器类class MyMenuItemClickListener implements OnMenuItemClickListener {    @Override    publicboolean onMenuItemClick(MenuItem item) {        // do something here...returntrue;    //finish handling    }}//第二步：为菜单项注册监听器menuItem.setOnMenuItemClickListener(new MyMenuItemClickListener());
复制代码 复制代码

android文档对onMenuItemClick(MenuItemitem)回调方法的说明是"Called when a menu item has been invoked. This is the first code that is executed; if it returns true, no other callbacks will be executed." 可见该方法先于onOptionsItemSelected执行。

3.使用Intent响应菜单

第3种方式是直接在MenuItem上调用setIntent(Intentintent)方法，这样android会自动在该菜单被点击时调用startActivity(Intent)。但是个人认为与其这样还不如直接在onOptionsItemSelected的case里手动调用startActivity(Intent)来的直观。

Android菜单详解（三）——SubMenu和IconMenu

我们在上一篇介绍了如何在Android中创建和响应选项菜单，今天我们将探索子菜单和图标菜单。

子菜单Sub Menu

理解Android的菜单_第4张图片

子菜单提供了一种自然的组织菜单项的方式，它被大量地运用在windows和其他OS的GUI设计中。Android同样支持子菜单，你可以通过addSubMenu(int groupId, int itemId, int order, int titleRes)方法非常方便的创建和响应子菜单。

复制代码 复制代码 
@Overridepublicboolean onCreateOptionsMenu(Menu menu) {    int base = Menu.FIRST;    // 一个menu可以包括多个子菜单    SubMenu subMenu = menu.addSubMenu(base, base+1, Menu.NONE, "系统设置");    // 子菜单可以包括多个菜单项    MenuItem menuitem1 = subMenu.add(base, base+1, base+1, "显示设置");    subMenu.add(base, base+2, base+2, "网络设置");    subMenu.add(base, base+3, base+3, "高级设置");    subMenu.add(base, base+4, base+4, "安全设置");        // 子菜单项不支持显示图标，这样做是没意义的，尽管不会报错！    menuitem1.setIcon(R.drawable.displaysettings);        //但是子菜单本身是支持图标的    subMenu.setIcon(R.drawable.settings);        // 显示菜单请返回truereturntrue;}
复制代码 复制代码

理解Android的菜单_第5张图片理解Android的菜单_第6张图片理解Android的菜单_第7张图片

上面的代码演示了如何创建子菜单，其菜单项的响应其实就是普通菜单项的响应，上一篇已经作了详细介绍，这里不再赘述。Android中可以为子菜单添加图标，但是不会显示其菜单项的图标，这一点需要留意。除了代码中的setIcon(int iconRes)方法，还有一个setHeaderIcon(int iconRes)方法可以添加子菜单项栏目的标题图标，效果如上面第三张图。

最后需要强调的是，Menu可以包含多个SubMenu，SubMenu可以包含多个MenuItem（这三者之间的关系见Android菜单详解（一）——理解Android中的Menu），但是SubMenu不能包含SubMenu，及子菜单不能嵌套！！！下面的代码能通过编译，但会在运行时出错。

subMenu.addSubMenu("又一个子菜单");

图标菜单Icon Menu

Android支持在菜单上显示各种各样的图标，这一点我们在上面创建子菜单时已经用到了。图标菜单严格上说并不算是一种菜单的新类型，它的使用也很简单，之所以单独设一节是为了说明使用Icon的一些限制。Android中并不是所谓的菜单项都能加上图标，以下菜单项都是不可以的（这并不意味着程序会报错，而是运行时图标得不到显示）：

  • 扩展的菜单项。如果不理解什么是扩展的菜单，可以参考Android菜单详解（一）——理解Android中的Menu
  • 子菜单的菜单项
  • 上下文菜单的菜单项

除此以外，带Icon的菜单项不能加上复选框(check mark)。总之，虽然精美的图标能给我们的应用增色不少，但是滥用图标也是会适得其反的，Android SDK给图标菜单加的这些限制也算是有效的防止我们滥用图标了吧。

结语

本篇介绍了Android中的子菜单和给菜单项加Icon时需要注意的几点，下一篇《Android菜单详解（四）——使用上下文菜单ContextMenu》将介绍上下文菜单Context Menu的使用。

之前在《Android菜单详解（二）——创建并响应选项菜单》和《Android菜单详解（三）——SubMenu和IconMenu》中详细讲解了选项菜单，子菜单和图标菜单。今天接着细说另一种被广泛使用的菜单——上下文菜单Context Menu。

ContextMenu简介

在Windows中，我们已经习惯了在文件上单击右键来执行“打开”、“重名名”、“剪切”、“删除”等操作，这个右键弹出的菜单就是上下文菜单。你可能会笑道：“哈哈，你不会连快捷键都不会用吧？”。咳咳，这个。。。举个例子嘛。没错，windows中快捷键能帮助我们提高操作的效率，但是android中这招可不管用喽，注意：android的上下文菜单项是不能用快捷键的。因为手机的操作方式与使用鼠标的PC操作方式不同，android是通过长按某个视图元素来弹出上下文菜单的（PS：现在大多数智能机是全触屏的，没有物理键盘，更没有使用快捷键的需要了，这项革新要归功于乔布斯在07发布的革命手机iPhone，老乔退休了，向他致敬！）。除此之外，甚至连图标和子菜单都无法用在Android的上下文菜单项中。那么，Android的上下文菜单到底如何使用？见下图

理解Android的菜单_第8张图片

如图，上下文菜单继承了android.view.Menu，因此我们可以像操作Options Menu那样给上下文菜单增加菜单项。上下文菜单与Options Menu最大的不同在于，Options Menu的拥有者是Activity，而上下文菜单的拥有者是Activity中的View。每个Activity有且只有一个Options Menu，它为整个Activity服务。而一个Activity往往有多个View，并不是每个View都有上下文菜单，这就需要我们显示地通过registerForContextMenu(Viewview)来指定。

尽管上下文菜单的拥有者是View，生成上下文菜单却是通过Activity中的onCreateContextMenu(ContextMenumenu,Viewv,ContextMenu.ContextMenuInfomenuInfo)方法，该方法很像生成Options Menu的onCreateOptionsMenu(Menumenu)方法。两者的不同在于，onCreateOptionsMenu只在用户第一次按“Menu”键时被调用，而onCreateContextMenu会在用户每一次长按View时被调用，而且View必须已经注册了上下文菜单。

另一个值得注意的就是上图中的ContextMenuInfo，该类的对象被传入onCreateContextMenu(ContextMenumenu,Viewv,ContextMenu.ContextMenuInfomenuInfo)方法，那么它有什么用呢？有时候，视图元素需要向上下文菜单传递一些信息，比如该View对应DB记录的ID等，这就要使用ContextMenuInfo。需要传递额外信息的View需要重写getContextMenuInfo()方法，返回一个带有数据的ContextMenuInfo实现类对象。

介绍了这么多，下面给出一个demo演示如何创建和响应上下文菜单：

1.在activity的onCreate(...)方法中为一个view注册上下文菜单

2.在onCreateContextMenuInfo(...)中生成上下文菜单。

3.在onContextItemSelected(...)中响应上下文菜单项。

Demo:使用上下文菜单

理解Android的菜单_第9张图片理解Android的菜单_第10张图片

1）注册上下文菜单

复制代码 复制代码 
/** * 上下文菜单演示Demo *  * @author CodingMyWorld 2011-8-27 下午03:22:39 */publicclass SampleContextMenuActivity extends ListActivity {    privatestaticfinal String TAG ="SampleContextMenuActivity";    @Override    protectedvoid onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        // 显示列表        simpleShowList();        // 为所有列表项注册上下文菜单this.registerForContextMenu(getListView());    }    privatevoid simpleShowList() {        // list item        String[] files =new String[] {            "文件1",            "文件2",            "文件3",            "文件4"        };        // simple array adapter        ArrayAdapter<String> adapter =new ArrayAdapter<String>(                this,                 android.R.layout.simple_list_item_1,                files);        // set adapterthis.setListAdapter(adapter);        Log.v(TAG, "show simple list");    }}
复制代码 复制代码

2）生成上下文菜单

在activity中重写方法。

复制代码 复制代码 
@Overridepublicvoid onCreateContextMenu(ContextMenu menu, View v,        ContextMenuInfo menuInfo) {    Log.v(TAG, "populate context menu");    // set context menu title    menu.setHeaderTitle("文件操作");    // add context menu item    menu.add(0, 1, Menu.NONE, "发送");    menu.add(0, 2, Menu.NONE, "标记为重要");    menu.add(0, 3, Menu.NONE, "重命名");    menu.add(0, 4, Menu.NONE, "删除");}
复制代码 复制代码

3）响应上下文菜单项

与响应options menu类似，唯一的不同是可以通过menu info获得额外的信息。

复制代码 复制代码 
@Overridepublicboolean onContextItemSelected(MenuItem item) {    // 得到当前被选中的item信息    AdapterContextMenuInfo menuInfo = (AdapterContextMenuInfo) item.getMenuInfo();    Log.v(TAG, "context item seleted ID="+ menuInfo.id);        switch(item.getItemId()) {    case1:        // do somethingbreak;    case2:        // do somethingbreak;    case3:        // do somethingbreak;    case4:        // do somethingbreak;    default:        returnsuper.onContextItemSelected(item);    }    returntrue;}
复制代码 复制代码

运行程序，多次唤出上下文菜单，注意LogCat的输出，onCreateContextMenu每一次都被调用了。

结语

至此，我们介绍完了android中的各种常用菜单，但是目前为止我们都是通过硬编码来增加菜单项的，android为此提供了一种更便利的方式，将在下一节“使用XML生成菜单”中介绍。

Android菜单详解（五）——使用XML生成菜单

回顾前面的几篇，我们都是直接在代码中添加菜单项，给菜单项分组等，这是比较传统的做法，它存在着一些不足。比如说，为了响应每个菜单项，我们需要用常量来保存每个菜单项的ID等。为此，Android提供了一种更好的方式，就是把menu也定义为应用程序的资源，通过android对资源的本地支持，使我们可以更方便地实现菜单的创建与响应。这一篇就介绍如何使用XML文件来加载和响应菜单，我们需要做这几步：

  1. 在/res目录下创建menu文件夹
  2. 在menu目录下使用与menu相关的元素定义xml文件，文件名是随意的，android会自动为其生成资源ID。例如：R.menu.mainmenu对应menu目录的mainmenu.xml资源文件
  3. 使用xml文件的资源ID，将xml文件中定义的菜单项添加到menu对象中
  4. 响应菜单项时，使用每个菜单项对应的资源ID

下面就使用xml的方式完成《Android菜单详解（二）——创建并响应选项菜单》中的options menu。

定义菜单资源文件

在res目录下创建menu文件夹，在menu下创建一个xml资源文件，我这里叫做mainmenu.xml

理解Android的菜单_第11张图片

编写mainmenu.xml如下：

复制代码 复制代码 
<?xml version="1.0" encoding="utf-8"?><menu  xmlns:android="http://schemas.android.com/apk/res/android">  <!-- group1 -->  <group android:id="@+id/group1">      <item android:id="@+id/mi1"          android:title="item1"/>      <item android:id="@+id/mi2"          android:title="item2"/>  </group>  <!-- group 2 -->  <group android:id="@+id/group2">      <item android:id="@+id/mi3"          android:title="item3"/>      <item android:id="@+id/mi4"          android:title="item4"/>  </group>  </menu>
复制代码 复制代码

这里简单的添加了4个菜单项，并将其分为2组。item元素的android:title值可以引用values中的string资源。

使用MenuInflater添加菜单项

inflater在android中建立了从资源文件到对象的桥梁，MenuInflater即把菜单xml资源转换为对象并添加到menu对象中，它可以通过activity的getMenuInflater()得到。我们在MainActivity中重写onCreateOptionsMenu(...)方法。

@Overridepublicboolean onCreateOptionsMenu(Menu menu) {    MenuInflater inflater = getMenuInflater();    inflater.inflate(R.menu.mainmenu, menu);    returntrue;}

响应菜单项

最后重写onOptionsItemSeleted(...)方法。

复制代码 复制代码 
@Overridepublicboolean onOptionsItemSelected(MenuItem item) {    switch(item.getItemId()) {    case R.id.mi1:        // do sthbreak;    case R.id.mi2:        // do sthbreak;    case R.id.mi3:        // do sthbreak;    case R.id.mi4:        // do sthbreak;    }    returntrue;}
复制代码 复制代码

这一步最大的体现了使用XML生成菜单的好处。android不仅为我们定义的xml文件生成了资源ID，同样可以为group,menu item来自动生成ID（就像为布局中定义的view生成id那样）。这样菜单项ID的创建与管理就不用我们操心了，全部交给android去做吧！

至此，我们完成了一个简单的“使用XML生成菜单”的demo，并从中体会到了使用资源文件的好处，因此这是android中创建菜单的推荐方式。实际上，我们在代码中对菜单项或分组的操作都能在xml文件中完成，下面就简单介绍一些比较常用的功能。（谷歌提供的API demos中有最全面的示例）

更多菜单资源文件的功能

1.资源文件实现子菜单

子菜单通过在item元素中嵌套menu来实现。

复制代码 复制代码 
<item android:title="系统设置">    <menu>        <item android:id="@+id/mi_display_setting"            android:title="显示设置"/>        <item android:id="@+id/mi_network_setting"            android:title="网络设置"/>        <!-- 别的菜单项 -->    </menu></item>
复制代码 复制代码

2.为菜单项添加图标

<item android:id="@+id/mi_exit"    android:title="退出"    android:icon="@drawable/exit"/>

3.设置菜单项的可选出现

使用android:checkableBehavior设置一组菜单项的可选策略，可选值为：none, all, single

<group android:id="..."    android:checkableBehavior="all">    <!-- 菜单项 --></group>

使用android:checked设置特定菜单项

<item android:id="..."    android:title="sometitle"    android:checked="true"/>

4.设置菜单项可用/不可用

<item android:id="..."    android:title="sometitle"    android:enabled="false"/>

5.设置菜单项可见/不可见

<item android:id="..."    android:title="sometitle"    android:visible="false"/>

结语

本篇是Android菜单详解系列的最后一篇，本系列详细介绍了android中各种常用菜单的使用技巧和注意事项，希望能帮助大家更好的理解，也期待与各位交流开发中的心得：）

更多相关文章

  1. android 开发中判断网络是否连接的代码
  2. android设置横屏代码
  3. Android数据库代码备忘
  4. eclipse中查看Android SDK源代码
  5. Android 菜单(OptionMenu)
  6. Android获取运营商代码

随机推荐

  1. Nginx架构详解(二)：nginx反向代理配置
  2. 跟我自学linux第15天项目作业
  3. 跟我自学linux第二天笔试题
  4. MongoDB实战篇(七)：使用索引
  5. 教你如何在快应用中跳转到Android的app
  6. 黑盒测试只会点点点 这些你都需要知道
  7. DolphinDB丨金融高频因子流批一体计算神
  8. 阿里高并发Netty开源框架，撸完人已猝！！！
  9. 深度学习-3D点云实战系列
  10. K8S部署API网关Kong