Android菜单

Android菜单概述

菜单是Activity的一个重要组成部分，它为用户操作提供了快捷的途径。Android提供了一个简单的框架来向程序中添加标准菜单 。

一、创建一个菜单资源

你需要在一个XML 菜单资源中定义一个菜单而不是在代码中，然后在代码中inflate这个菜单资源。使用菜单资源来定义菜单是一个很佳的做法，因为这样可以使界面与代码分离。并且在XML中更容易设计你的菜单。

要创建一个菜单资源，先在你项目的res/menu/下创建一个XML文件，然后用以下元素建立菜单：

<menu>

定义一个菜单，它是菜单项的容器。 <menu>必须是文件的根节点，其内部可包含一个或多个<item>和<group> 元素。

<item>

创建一个菜单项。菜单项中可以继续包含<menu>元素，此时它就具有了子菜单。

<group>

一个可选的，不可见的，容纳<item> 元素的容器。它使你能够对菜单项进行分类，从而使同类的菜单项共享一些属性，比如活动状态，可见状态等。

1、以下是一个菜单的例子，菜单名为 game_menu.xml:

<?xml version="1.0" encoding="utf-8"?>  
<menu xmlns:android="http://schemas.android.com/apk/res/android">  
    <item android:id="@+id/new_game"  
          android:icon="@drawable/ic_new_game"  
          android:title="@string/new_game" />  
    <item android:id="@+id/help"  
          android:icon="@drawable/ic_help"  
          android:title="@string/help" />  
</menu>  

此例中定义了两个菜单项，每个包含属性有：

android:id：一个资源ID来标志菜单项，当用户选择某个菜单项时，程序可以用这个ID来识别这个菜单项．

android:icon：引用一个drawable用于菜单项的图标。

android:title：引用一个字符串用于菜单项的标题。

还有很多可以在<item>中使用的属性，还包含指定菜单项如何在Action Bar中显示的属性。

2、Inflating 一个菜单资源

在 代码中，使用方法 MenuInflater.inflate()你可以inflate（把一个XML资源转换为程序中的对象）一个菜单资．例如，下面的代码在回调方法 onCreateOptionsMenu()中把文件 game_menu.xml inflate成一个菜单对象，从而作为这个Activity的选项菜单使用：

@Override  
public boolean onCreateOptionsMenu(Menu menu) {  
    MenuInflater inflater = getMenuInflater();  
    inflater.inflate(R.menu.game_menu, menu);  
    return true;  
}  

方 法 getMenuInflater() 返回Activity的一个 MenuInflater ，使用这个对象，你可以调用 inflate(), 把菜单资源转换为 菜单 对象．在这个例子中，菜单资源被inflate到方法onCreateOptionsMenu()的参数 Menu中． (这个方法在下面会详细讨论)．

二、android的菜单有三种：

1、选项菜单Options Menu

当用户按下menu button（手机上的menu按钮）按钮时显示的菜单

1.1、创建一个选项菜单

选项菜单里应该包含基本的activity动作和必须的导航条目 (例如，一个打开程序设置的菜单项). 选项菜单的菜单项有两种不同的选择方法，一是菜单项按钮，二是通过 Action Bar (在Android 3.0及以上版本中).

??

图１：浏览器中的选项菜单

图 2. Email程序中的动作栏，具有两个动作和一个溢出菜单

当 运行于Android 2.3及更低版本时，选项菜单出现在屏幕的底部，见图１.当打开选项菜单时，首先映入眼帘的是图标菜单，它有六个菜单项，如果你加入了多于六个菜单项，系 统会把第六个菜单项和后面的菜单项放到溢出菜单中，用户可以通过 "More"菜单项打开它们．

Android 3.0及以后版本中，选项菜单项被放在Action Bar上．Action Bar位于Activity的顶部传统的Title bar所在的位置．默认情况下，所有的来自选项菜单的菜单项都衣放入溢出菜单中．用户可以触击Action bar右边的菜单图标以打开之．但是，你也可以把菜单项作为"action items"直接放到 Action Bar上 ，像图２所示那样.

当系统第一次创建选项菜单时，它调用你的activity的方法 onCreateOptionsMenu() . 重写这个方法并且为传入的参数 Menu 创建实例．Menu 是通过inflate一个菜单资源创建的，如下:

.     @Override  
.     .         MenuInflater inflater .         inflater.inflate(R.menu.game_menu, menu);  
.         .     }  

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.game_menu, menu);
    return true;
}

你也可以在代码中产生menu，然后使用方法 add() 添加菜单项.
注意:在Android 2.3 及更低版本中，当用户第一次打开选项菜单时系统调用 onCreateOptionsMenu() 创建选项菜单,但是在Android 3.0及更高版本中, 系统在Activity一创建时就创建选项菜单，为的是创建Action Bar.

1.2、响应用户动作

当用户选择一个菜单项 (也包括Action Bar上的动作项), 系统会调用你的activity的方法 onOptionsItemSelected() ．这个方法会在参数中传入选择的菜单项．你可以通过调用方法getItemId()定位这个菜单项 ,这个方法会返回菜单项的唯一ID (在菜单资源文件中以android:id属性定义或在调用方法add()时传入的整数). 你可以使用已知的菜单项来匹配这个ID并执行相关的动作。

例如：

.     @Override  
.     .         .         .         .             newGame();  
.             .         .             showHelp();  
.           .       .           .       }  
.   }  

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    // Handle item selection
    switch (item.getItemId()) {
    case R.id.new_game:
        newGame();
        return true;
    case R.id.help:
        showHelp();
        return true;
    default:
        return super.onOptionsItemSelected(item);
    }
}

在 这个例子中, getItemId() 获取所选菜单项的ID并在switch语句中与资源文件中所有菜单ID比较。当switch语句中成功处理了菜单项，就返回 true 以表明所选 的菜单项被处理了。否则，default 语句会把菜单项传给父类，也许父类会处理这个菜单项 (如果你直接从 Activity派生，那么父类会返回false, 但是把未处理的菜单项传给父类而不是直接返回false是一个好习惯.)

另外, Android 3.0 增加了在菜单资源XML文件中定义菜单项的点击行为的能力，这个能力通过 android:onClick 属性定义 。所以你不需要实现 onOptionsItemSelected(). 使用 android:onClick 属性，你可以指定一个方法在菜单项被选择时调用. 你的 activity 必须实现在属性android:onClick中指定的方法，它接受一个MenuItem 参数---当系统调用这个方法时选中的菜单从这个参数传入。

小 技巧:如果你的程序中包含多个 activitie并且它们提供相同的选项菜单，应考虑创建一个只实现了 onCreateOptionsMenu() 和 onOptionsItemSelected()的activity 类，然后让那些提供相同选项菜单的activity都从这个类派生.通过这种方式，你只需为这个类的子孙们管理一组代码。

如果你想在孙子 activitie们中添加菜单项，只需重写 onCreateOptionsMenu().。在其中调用 super.onCreateOptionsMenu(menu) ，于是原始的菜单被创建，然后通过方法menu.add()添加新菜单项。你也可以重写父类的方法来创建另外的菜单项们。

1.3、在运行时改变菜单项们

一旦activity被创建，方法onCreateOptionsMenu() 只会被调用一次（前面已经说过）．系统会保存并重用这个菜单，直到你的activity被销毁．如果你想在菜单创建后再去改变它怎么办呢？你必须重写方法 onPrepareOptionsMenu() . 它会传给你已创建的菜单的实例.在你想跟据应用的状态删除，添加，disable, or enable菜单项们的时候就用到这个函数了.

在 Android 2.3和其之前的版本，系统在每次打开选项菜单时都会调用 onPrepareOptionsMenu() .

在 Android 3.0 及以后版本中，你必须在你想更新菜单之前主动调用方法 invalidateOptionsMenu() , 因为菜单是一直打开的．系统之后会调用onPrepareOptionsMenu() ，于是你就可以更改菜单项了.

注: 你永远不要更改当前具有焦点的View的选项菜单．当处于触摸模式 (用户没有使用轨迹球或方向键), views不能取得焦点,所以你永远不能基于焦点来修改选项菜单的菜单项目． 如果你想为View提供上下文敏感的菜单项，使用 Context Menu.

如果你正在开发 Android 3.0 或更高版本之上的应用，还需阅读 Action Bar 的开发指南.

2、子菜单Submenu

当用户按下一个菜单的某个选项时弹出的子菜单

2.1、创建子菜单们

一个子菜单是一个在已有菜单的某个菜单项上打开的菜单．你可以向任何菜单添加子菜单．当你的程序拥有很多功能并可按类别组织起来，那么子菜单是最佳选择．比如PC 程序中的菜单栏 (File, Edit,View等等.)．

当创建你的菜单资源时，你可以添加一个<menu> 元素作为一个<item>元素的孩子来创建子菜单．例如：

<?xml version="1.0" encoding="utf-8"?>  
<menu xmlns:android="http://schemas.android.com/apk/res/android">  
    <item android:id="@+id/file"  
          android:icon="@drawable/file"  
          android:title="@string/file" >  
        <!-- "file" submenu -->  
        <menu>  
            <item android:id="@+id/create_new"  
                  android:title="@string/create_new" />  
            <item android:id="@+id/open"  
                  android:title="@string/open" />  
        </menu>  
    </item>  
</menu> <?xml version="1.0" encoding="utf-8"?><menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/file"
          android:icon="@drawable/file"
          android:title="@string/file" >
        <!-- "file" submenu -->
        <menu>
            <item android:id="@+id/create_new"
                  android:title="@string/create_new" />
            <item android:id="@+id/open"
                  android:title="@string/open" />
        </menu>
    </item>
</menu>

当用户从一个子菜单中选择一个菜单项， 父菜单的响应菜单项选择的回调方法会接收到事件．例如，如果上述菜单是一个选项菜单，那么方法 onOptionsItemSelected() 就会被调用．

你也可以使用 addSubMenu()来动态添加子菜单到一个菜单中．这个方法会返回一个新的 SubMenu 对象， 你可以使用add()方法向这个SubMenu对象添加菜单项．

3、上下文菜单Context Menu

上下文菜单,类似于右键菜单,当用户长久按住屏幕，即被注册显示上下文菜单的视图时显示的菜单

3.1、创建一个上下文菜单

一个上下文菜单跟ＰＣ上的右键菜单类似．你应使用上下文菜单为用户界面上的某个部分提供动作选择功能．在Android中，一个上下文菜单会在用户长按一个界面条目时出现．你可以为任何View创建上下文菜单,但是在 ListView中是最常用到上下文菜单的．每当用户在一个ListView项上长按，并且这个ListView注册了上下文菜单，那么被按的 list item就会弹出上下文菜单 (在联系人应用中就演示了这个过程)．

Register a ListView

如果你的activity使用一个ListView并且你希望所有的list items都提供一个上下文菜单，应把ListView传给方法registerForContextMenu()，在OnCreate（）方法中注册，例如：

registerForContextMenu(getListView());

为了使view提供上下文菜单，你必须为这个View向系统注册上下文菜单．调用方法 registerForContextMenu() 并传入要弹出菜单的 View 作为参数即可．当这个View被长按时，它就会显示一个上下文菜单．为了定义上下文菜单的样子和行为，需重写你的activity的上下文菜单回调方法：onCreateContextMenu() 和onContextItemSelected().

例如，下面是一个 onCreateContextMenu() ，使用了资源文件 context_menu.xml :

.     @Override  
.     .      ContextMenuInfo menuInfo)
.      {  
.       .       MenuInflater inflater .       inflater.inflate(R.menu.context_menu, menu);  
.     }  

@Override
public void onCreateContextMenu(ContextMenu menu, View v,
                                ContextMenuInfo menuInfo) {
  super.onCreateContextMenu(menu, v, menuInfo);
  MenuInflater inflater = getMenuInflater();
  inflater.inflate(R.menu.context_menu, menu);
}

MenuInflater 被用于从一个 菜单资源inflate出一个菜单． (你也可以使用 add() 来添加菜单项们) ．回调函数的参数中包含了用户所选择的View 和一个ontextMenu.ContextMenuInfo 对象，它可以提供被选择的View的更多的信息．你可以使用这些参数来决定哪个上下文菜单应被创建．但是在这个例子中，Activity所有的上下文菜单都是相同的.然后，当用户从上下文菜单选择一个菜单项时，系统会调用方法 onContextItemSelected(). 下面的例子展示了如何处理被选择的菜单项：

.     @Override  
.     .       AdapterContextMenuInfo info .       .       .         editNote(info.id);  
.         .       .         deleteNote(info.id);  
.       .     .       .     }  
.   }  

@Override
public boolean onContextItemSelected(MenuItem item) {
  AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
  switch (item.getItemId()) {
  case R.id.edit:
    editNote(info.id);
    return true;
  case R.id.delete:
    deleteNote(info.id);
    return true;
  default:
    return super.onContextItemSelected(item);
  }
}

这些代码与选项菜单中的例子代码基本相同．getItemId() 从所选的菜单项获取菜单ID，并且使用switch语句匹配菜单ID与对应的处理．并且同于选项菜单的例子，default语句调用父类的同一方法处理未被我们处理的菜单项．

在此例中，被选择的View条目是一个 ListView条目．为了在选择的一个view条目上执行相应的动作，应用程序需要知道View条目的list ID．为了获得 list ID,程序中调用了 getMenuInfo(), 它返回一个 AdapterView.AdapterContextMenuInfo 对象，这个对象包含了条目的list ID．本地方法editNote()和deleteNote()接受这个list ID用于执行一些作．

注: 上下文菜单项不支持图标或快捷键．

三、快捷键和菜单intent

为了提高对选项菜单的操作速度，你可以在具有物理按键的设备上为菜单增加快捷键．快捷键可以对应键盘上的字母或数字．你需要做的是为<item>元素指定属性android:alphabeticShortcut 和android:numericShortcut 的值．你也可以在代码中使用方法setAlphabeticShortcut(char) 和setNumericShortcut(char).来完成．快捷键并不是大小写敏感的．

例如，如果你把"s"键作为菜单项 "save" 的快捷键，那么当菜单打开时，用户按下了 "s" 键，"save"菜单项就被选择．

快捷键会以tip的方式出现在菜单项的名字的下方(除非菜单是图标菜单，它只能在用户按下＂菜单＂键时出现)．

注:快捷键只能在有物理键盘的设备上起作用，并且不能用在上下文菜单上．

1、动态添加菜单intents

有时你可能希望通过一个菜单项使用Intent启动一个activiry(不论这个activity在你自己的程序中还是在另一个程序中 )．如果你知道了需要的Intent，你可以在响应对应菜单项的回调方法中执行Intent的startActivity()方法完成．

然而，如果你不能确信用户设备上具有响应这个intent的程序，那么添加的菜单项可能成多余的．为了解决这个问题，Android 允许你在发现具有所有响应目标intent的activity时动态添加菜单项．

要跟据是否具有响应目标intent的Activity来添加菜单项，你需要：

定义一个具有类别 CATEGORY_ALTERNATIVE 和/或CATEGORY_SELECTED_ALTERNATIVE的intent，当然还可以跟据需要添加其它类别．

调用 Menu.addIntentOptions(). Android会查找可以执行这个的程序然后把它添加到你的菜单上．

如此一来，如果没有满之intent的程序存在，则没有菜单项会添加．

注:CATEGORY_SELECTED_ALTERNATIVE 被用于处理屏幕上当前被选择的元素．所以，它只能用于在onCreateContextMenu()中被建的菜单．

例如:

@Override  
,      ,      ,      // Additional flags to control items (none)  
         null);  // Array of MenuItems that correlate to specific items (none)  
  
    return true;  
}  

每发现一个对应这个intent的activity，就会添加一个菜单项．将intent 过滤器中 android:label 的值作为菜单项的标题，将程序的图标作为菜单项的图标． 方法addIntentOptions() 返回被添加的菜单项的数目.

注:当调用 addIntentOptions()时，会将参数menu group所指的group下的所有菜单项替换掉．

2、允许你的activity能被添加到其它菜单中

你也可以把你的activity的服务向其它程序提供．于是你的程序可以被其它程序的菜单所包含 (跟上一小节反过来了).

要想能被其它程序的菜单所包含，你需要定义一个intent 过滤器， 但这个过滤器必须在类别中包含 CATEGORY_ALTERNATIVE 和/或CATEGORY_SELECTED_ALTERNATIVE ，例如：

<intent-filter label="Resize Image">  
    ...  
    <category android:name="android.intent.category.ALTERNATIVE" />  
    <category android:name="android.intent.category.SELECTED_ALTERNATIVE" />  
    ...  
</intent-filter>