Android系统里面有3种类型的菜单:options menu,context menu,sub menu。
options menu 按Menu键就会显示,用于当前的Activity。
它包括两种菜单项:
因为options menu在屏幕底部最多只能显示6个菜单项,这些菜单项称为
icon menu ,icon menu只支持文字(title) 以及icon,可以设置快捷键,不支持checkbox以及radio控件,所以不能设置checkable选项。
而多于6的菜单项会以“more” icon menu来调出,称为
expanded menu 。它不支持icon,其他的特性都和icon menu一样!
在Activity里面,一般通过以下函数来使用options menu:
Activity::onCreateOptionsMenu (Menu menu)
创建options menu,这个函数只会在menu第一次显示时调用。
Activity::onPrepareOptionsMenu (Menu menu) 更新改变options menu的内容,这个函数会在menu每次显示时调用。
Activity::onOptionsItemSelected (MenuItem item) 处理选中的菜单项。
context menu 要在相应的view上按几秒后才显示的,用于view,跟某个具体的view绑定在一起。
这类型的菜单不支持icon和快捷键!
在Activity里面,一般通过以下函数来使用context menu:
Activity::registerForContextMenu(View view) 为某个view注册context menu,一般在Activity::onCreate里面调用。
Activity::onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) 创建context menu,和options menu不同,context meun每次显示时都会调用这个函数。
Activity::onContextItemSelected(MenuItem item) 处理选中的菜单项。
sub menu
以上两种menu都可以加入子菜单,但子菜单不能嵌套子菜单,这意味着在Android系统,菜单只有两层,设计时需要注意的!同时子菜单不支持icon。
xml形式的menu定义及应用
上述的三种类型的menu都能够定义为xml资源,但需要手动地使用
MenuInflater 来得到Menu对象的引用。
一个菜单,对应一个xml文件,因为要求只能有一个根节点<menu>。官方说<?xml>声明可以不写,但我觉得还是写上好 些,很多时候那个<?xml>声明主要是为了声明编码格式utf-8之类的。xml文件保存为res/menu /some_file.xml。Java代码引用资源:
R.menu.some_file
接下来介绍相关的节点和属性(所有的属性都定义为android空间内,例如android:icon="@drawable/icon"):
<menu> 根节点,没有属性。
<group> 表示在它里面的<item>在同一group。相关属性包括:
id :group id
menuCategory :对应 常量Menu CATEGORY_* — 定义了一组的优先权,有
<menu> 根节点,没有属性。
<group> 表示在它里面的<item>在同一group。相关属性包括:
id :group id
menuCategory :对应 常量Menu CATEGORY_* — 定义了一组的优先权,有
效值:container,system,secondary,和alternative
orderInCategory :定义这组菜单在菜单中的默认次序,int值
checkableBehavior :这组菜单项是否checkable。有效值:none,all(单选/单选按钮radio button),single(非单选/复选类型checkboxes)
visible :这组菜单是否可见 true or false
enabled :这组菜单是否可用,true or false
id : item id
menuCategory : 用来定义menu类别
orderInCategory : 用来定义次序,与一个组在一起(Used to define the order of the item, within a group
)
title : 标题
titleCondensed :标题摘要, 当原标题太长的时候,需要用简短的字符串来代替title
icon : icon 图标
alphabeticShortcut : 字母快捷键
numericShortcut :数学快捷键
checkable :是否为checkbox, true or false
checked :是否设置为checked状态,true or false
visible : 是否可见, true or false
enabled :是否可用,true or false
xml示例:
- <? xml version = "1.0" encoding = "utf-8" ?>
- < menu xmlns:android = "http://schemas.android.com/apk/res/android" >
- < item android:id = "@+id/item1"
- android:title = "Item 1"
- android:icon ="@drawable/icon"
- android:checkable = "true"
- android:checked = "false"
- />
- < group android:id = "@+id/group_1"
- android:checkableBehavior = "single" >
- < item android:id = "@+id/group_item1"
- android:title = "Item 1 in group"
- />
- < item android:id = "@+id/group_item2"
- android:title = "Item 2 in group"
- android:checked = "true"
- />
- </ group >
- < item android:id = "@+id/submenu"
- android:title = "Sub Menu" >
- < menu >
- < item android:id = "@+id/submenu_item"
- android:title = "Sub Menu Item"
- />
- </ menu >
- </ item >
- < item android:id = "@+id/item3"
- android:title = "item 3"
- android:checkable = "true"
- android:checked = "true"
- />
- </ menu >
Java代码
- public void onCreate(Bundle savedInstanceState) {
- ...
- registerForContextMenu(editText);
- }
- @Override
- public void onCreateContextMenu(ContextMenu menu, View v,
- ContextMenuInfo menuInfo) {
- super .onCreateContextMenu(menu, v, menuInfo);
- getMenuInflater().inflate(R.menu.menu1, menu);
- }
效果图
由于这是contextMenu,所以可以看到即使xml定义里面的item1.seticon了,但还是没有显示出来的,即那语句是无效的!
另外,要明确的是,要显示radio,需要用group,而group里面的item设置了checked = true即选中。而 checkable和checked的区别,一开始我是很困惑的,但写了代码并运行后,明白它们的区别了:
checkable=true 表示这个item是checkbox,
checked 则表示是否选中。所以对于checkbox item,最好先写 checkable="true",然后再写checked。
Java实现
用Java来实现以上的效果图,就比较麻烦些:
- private static final int MENU_GROUPITEM1 = Menu.FIRST + 8 ;
- private static final int MENU_GROUPITEM2 = Menu.FIRST + 9 ;
- private static final int MENU_ITEM1 = Menu.FIRST + 10 ;
- public void onCreate(Bundle savedInstanceState) {
- ...
- registerForContextMenu(findViewById(R.id.edittext));
- }
- @Override
- public void onCreateContextMenu(ContextMenu menu, View v,
- ContextMenuInfo menuInfo) {
- super .onCreateContextMenu(menu, v, menuInfo);
- menu.add(1 ,MENU_ITEM1,Menu.NONE, "Item 1" ).setCheckable( true ).setChecked( false );
- // Group ID
- int groupId = 0 ;
- // The order position of the item
- int menuItemOrder = Menu.NONE;
- menu.add(groupId, MENU_GROUPITEM1, menuItemOrder, "Item 1 in group" );
- menu.add(groupId, MENU_GROUPITEM2, menuItemOrder, "Item 2 in group" )
- .setChecked(true );
- menu.setGroupCheckable(groupId, true , true ); //这句要写在group item的最后
- SubMenu subMenu = menu.addSubMenu("Sub Menu 1" );
- subMenu.add("Sub Menu Item" )
- .setOnMenuItemClickListener(new MenuItem.OnMenuItemClickListener() {
- @Override
- public boolean onMenuItemClick(MenuItem item) {
- Toast.makeText(HelloDemo.this ,
- "Sub Menu Item selected" ,
- Toast.LENGTH_SHORT).show();
- return true ; //true表示完成当前item的click处理,不再传递到父类处理
- }
- });
- menu.add("Item 3" ).setCheckable( true ).setChecked( true );
- }
在编写过程中,发现groupId的影响很大,不推荐使用Menu.add(int titleRes)和add(CharSequence title)方法来添加MenuItem,因为没有指定groupID,默认为0,这样子和后面的menu group 一组了,导致执行完
menu.setGroupCheckable(groupId, true , true )后同一group的Item都变成radio。
OptionsMenu的Java实现
- @Override
- public boolean onCreateOptionsMenu(Menu menu) {
- // Group ID
- int groupId = 0 ;
- // The order position of the item
- int menuItemOrder = Menu.NONE;
- menu.add(groupId, MENU_COPY, menuItemOrder, "Copy" )
- .setIcon(R.drawable.icon);
- menu.add(groupId, MENU_EDIT, menuItemOrder, "Edit" );
- menu.add(groupId, MENU_PASTE, menuItemOrder, "Paste" );
- menu.add(groupId, MENU_DELETE, menuItemOrder, "Delete" );
- menu.add(groupId, MENU_OK, menuItemOrder, "Ok" );
- menu.add(groupId, MENU_CANCEL, menuItemOrder, "Cancel" );
- menu.add(groupId, MENU_TEST, menuItemOrder, "Test" );
- menu.add(groupId, MENU_DEMO, menuItemOrder, "Demo" );
- // .setIcon(R.drawable.icon); more expand menu 不支持icon, setIcon不会报错,但运行时还是看不到icon的
- //return super.onCreateOptionsMenu(menu);
- return true ; //true表示要显示menu; false表示不显示menu
- }
处理菜单点击事件
方法一:
利用菜单自带的监听器功能,直接监听,就象处理控件事件一样,像上面的ContextMenu的
subMenu.add("Sub Menu Item" )设置MenuItem.OnMenuItemClickListener。
方法二:
在Activity和View都直接提供了一个菜单点击统一处理函数,
Activity::onOptionsItemSelected (MenuItem item) ;
Activity::onContextItemSelected(MenuItem item) ;
- @Override
- public boolean onOptionsItemSelected(MenuItem item) {
- switch (item.getItemId()){
- case MENU_COPY:
- Toast.makeText(this , "Copy Item selected" , Toast.LENGTH_SHORT).show();
- break ;
- default : break ;
- }
- return false ; //false表示继续传递到父类处理
- }
效果图
动态菜单
对于OptionsMenu,一般可以使用onPrepareOptionsMenu来改变。
另外,使用函数
android.view.Menu.addIntentOptions(int groupId,int itemId,int order,ComponentName caller, Intent[] specifics, Intent intent,int flags,MenuItem[] outSpecificItems)
Specifics 以action+uri的具体方式来增加激活相应activity的菜单项
Intent 以categroy+uri这种一般形式来增加激活相应activity的菜单项
参数Intent和Specifics的区别是,一个用categroy+uri来匹配activity,一个用action+uri来匹配activity。
//按Action查找
Intent[] specifics = new Intent[1];
specifics[0] = new Intent(Intent.ACTION_EDIT, uri);
//按Category查找,Action设为null
Intent intent = new Intent(null, uri);
intent.addCategory(Intent.CATEGORY_ALTERNATIVE);
MenuItem[] items = new MenuItem[1];
menu.addIntentOptions(Menu.CATEGORY_ALTERNATIVE, 0, 0, null, specifics, intent, 0, items);
有关Menu的创建可以参考官方的
http://androidappdocs.appspot.com/guide/topics/ui/menus.html 。另外官方提供了Menu Design Guidelines
http://androidappdocs.appspot.com/guide/practices/ui_guidelines/menu_design.html
本文出自 “学习Android ” 博客,请务必保留此出处http://android.blog.51cto.com/268543/306424