创建一个选项菜单

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


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


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

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

@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.


响应用户动作

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

@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()添加新菜单项。你也可以重写父类的方法来创建另外的菜单项们。


在运行时改变菜单项们

一旦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 的开发指南.