Android UI学习 – Menu

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_*  — 定义了一组的优先权，有
效值：container，system，secondary，和alternative            orderInCategory：定义这组菜单在菜单中的默认次序，int值            checkableBehavior：这组菜单项是否checkable。有效值：none，all(单选/单选按钮radio button)，single(非单选/复选类型checkboxes)            visible：这组菜单是否可见 true or false            enabled：这组菜单是否可用，true or false       <item>  菜单项，可以嵌入<menu>作为子菜单。相关属性包括：         
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