Android菜单
Android菜单概述
菜单是Activity的一个重要组成部分，它为用户操作提供了快捷的途径。Android提供了一个简单的框架来向程序中添加标准菜单 。
一、创建一个菜单资源
你需要在一个XML 菜单资源中定义一个菜单而不是在代码中，然后在代码中inflate这个菜单资源。使用菜单资源来定义菜单是一个很佳的做法，因为这样可以使界面与代码分离。并且在XML中更容易设计你的菜单。
要创建一个菜单资源，先在你项目的res/menu/下创建一个XML文件，然后用以下元素建立菜单：
<menu>
定义一个菜单，它是菜单项的容器。 <menu>必须是文件的根节点，其内部可包含一个或多个<item>和<group> 元素。
<item>
创建一个菜单项。菜单项中可以继续包含<menu>元素，此时它就具有了子菜单。
<group>
一个可选的，不可见的，容纳<item> 元素的容器。它使你能够对菜单项进行分类，从而使同类的菜单项共享一些属性，比如活动状态，可见状态等。
1、以下是一个菜单的例子，菜单名为 game_menu.xml:
<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的选项菜单使用：
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一个菜单资源创建的，如下:
2. public boolean onCreateOptionsMenu(Menu menu) {
3. MenuInflater inflater = getMenuInflater();
4. inflater.inflate(R.menu.game_menu, menu);
5. return true;
6. }
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并执行相关的动作。
例如：
2. public boolean onOptionsItemSelected(MenuItem item) {
3. // Handle item selection
4. switch (item.getItemId()) {
5. case R.id.new_game:
6. newGame();
7. return true;
8. case R.id.help:
9. showHelp();
10. return true;
11. default:
12. return super.onOptionsItemSelected(item);
13. }
14. }
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>元素的孩子来创建子菜单．例如：
<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 :
2. public void onCreateContextMenu(ContextMenu menu, View v,
3. ContextMenuInfo menuInfo)
4. {
5. super.onCreateContextMenu(menu, v, menuInfo);
6. MenuInflater inflater = getMenuInflater();
7. inflater.inflate(R.menu.context_menu, menu);
8. }
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(). 下面的例子展示了如何处理被选择的菜单项：
2. public boolean onContextItemSelected(MenuItem item) {
3. AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
4. switch (item.getItemId()) {
5. case R.id.edit:
6. editNote(info.id);
7. return true;
8. case R.id.delete:
9. deleteNote(info.id);
10. return true;
11. default:
12. return super.onContextItemSelected(item);
13. }
14. }
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()中被建的菜单．
例如:
public boolean onCreateOptionsMenu(Menu menu){
super.onCreateOptionsMenu(menu);
// Create an Intent that describes the requirements to fulfill, to be included
// in our menu. The offering app must include a category value of Intent.CATEGORY_ALTERNATIVE.
Intent intent = new Intent(null, dataUri);
intent.addCategory(Intent.CATEGORY_ALTERNATIVE);
// Search and populate the menu with acceptable offering applications.
menu.addIntentOptions(
R.id.intent_group, // Menu group to which new items will be added
0, // Unique item ID (none)
0, // Order for the items (none)
this.getComponentName(), // The current activity name
null, // Specific items to place first (none)
intent, // Intent created above that describes our requirements
0, // 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 ，例如：
...
<category android:name="android.intent.category.ALTERNATIVE" />
<category android:name="android.intent.category.SELECTED_ALTERNATIVE" />
...
</intent-filter>
