Android开发之Menu：OptionMenu(选项菜单)、ContextMenu(上下文菜单)、SubMenu(子菜单)

菜单的概念，现在已经很普及了。
Windows系统、Mac、桌面版Linux、Java Swing等，都有可视化菜单。
一、Android平台3种菜单
  选项菜单(OptionMenu)、上下文菜单(ContextMenu)、子菜单(SubMenu)。


1.Option Menu 
一般手机上都会提供Menu的按钮，对应的就是这个菜单弹出。 


主要步骤就是复写Activity父类中的onCreateOptionMenu（Menu menu）方法，然后通过Menu的add方法来添加菜单进去，
最后，当我们去点击某项的选项的时候，覆盖重写onOptionsItemSelected(MenuItem item)这个方法去实现点击事件 。 


2.Context Menu 
上下文菜单，就是和当时的环境（用户界面、某个流程）相关的菜单。
比如对于文件管理器来说，一些增删改查就可以摆在ContextMenu中，它其实是实现了一个用户长按点击后弹出的来一个菜单。


3.SubMenu
  子菜单，在概念上，子菜单可以说是“属于”以上类型的。
  
二、理解Android菜单
  菜单是许多应用程序不可或缺的一部分，Android中更是如此，所有搭载Android系统的手机甚至都要有一个"Menu"键，由此可见菜单在Android程序中的特殊性。Android SDK提供的菜单有如下几种：


选项菜单：最常规的菜单，android中把它叫做option menu
子菜单：android中点击子菜单将弹出悬浮窗口显示子菜单项。子菜单不支持嵌套，即子菜单中不能再包括其他子菜单。
上下文菜单：android中长按视图控件后出现的菜单，windows点击右键弹出的菜单即上下文菜单
图标菜单：这个比较简单，就是带icon的菜单项，需要注意的是子菜单项、上下文菜单项、扩展菜单项均无法显示图标。
选择菜单(alternative menu)：用的比较少，以后单独介绍，本文先跳过（其实是我还没弄明白啦o(≧v≦)o~~）
扩展菜单：选项菜单最多只能显示6个菜单项，超过6个时，第6个菜单项会被系统替换为一个叫“更多”的子菜单，原来显示不下的菜单项都作为“更多”菜单的子菜单项。


Android SDK提供的菜单有如下几种：


选项菜单：最常规的菜单，android中把它叫做option menu
子菜单：android中点击子菜单将弹出悬浮窗口显示子菜单项。子菜单不支持嵌套，即子菜单中不能再包括其他子菜单。
上下文菜单：android中长按视图控件后出现的菜单，windows点击右键弹出的菜单即上下文菜单
图标菜单：这个比较简单，就是带icon的菜单项，需要注意的是子菜单项、上下文菜单项、扩展菜单项均无法显示图标。
选择菜单(alternative menu)：用的比较少。（网上找了篇文章，没有看懂，很陌生的感觉。）
扩展菜单：选项菜单最多只能显示6个菜单项，超过6个时，第6个菜单项会被系统替换为一个叫“更多”的子菜单，原来显示不下的菜单项都作为“更多”菜单的子菜单项。


android.view.Menu接口代表一个菜单，android用它来管理各种菜单项。
注意我们一般不自己创建menu，因为每个Activity默认都自带了一个，我们要做的是为它加菜单项和响应菜单项的点击事件。
android.view.MenuItem代表每个菜单项，android.view.SubMenu代表子菜单。其三者的关系可以用下图来表示


每个activity包含一个菜单，一个菜单又能包含多个菜单项和多个子菜单，子菜单其实也是菜单（因为它实现了Menu接口），因此子菜单也可以包含多个菜单项。
SubMenu继承了Menu的addSubMenu()方法，但调用时会抛出运行时错误。
OnCreateOptionsMenu()和OnOptionsMenuSelected()是activity中提供了两个回调方法，用于创建菜单项和响应菜单项的点击。




三、响应OptionMenu的3种方式
1.重写activity类的 onOptionsItemSelected(MenuItem)回调方法，每当有菜单项被点击时，android就会调用该方法，并传入被点击菜单项。
  publicboolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
    //响应每个菜单项(通过菜单项的ID)
case1:
        // do something here
break;


    default:
        //对没有处理的事件，交给父类来处理
return super.onOptionsItemSelected(item);
    }
    //返回true表示处理完菜单项的事件，不需要将该事件继续传播下去了
return true;
}

  这个地方的“default”，我觉得比较好。

2.使用监听器
虽然第一种方法是推荐使用的方法，android还是提供了类似java swing的监听器方式来响应菜单。使用监听器的方式分为两步:
//第一步：创建监听器类
class MyMenuItemClickListener implements OnMenuItemClickListener {
    @Override
    publicboolean onMenuItemClick(MenuItem item) {
        // do something here...
returntrue;    //finish handling
    }
}


//第二步：为菜单项注册监听器
menuItem.setOnMenuItemClickListener(new MyMenuItemClickListener());
3.使用Intent响应菜单
第3种方式是直接在MenuItem上调用setIntent(Intent intent)方法，这样android会自动在该菜单被点击时调用 startActivity(Intent)。
但是个人认为与其这样还不如直接在onOptionsItemSelected的case里手动调用 startActivity(Intent)来的直观。


个人比较倾向于第1种方式，如果菜单事件代码比较多，可以考虑第2种方式。
第2种方式的问题是，可能需要传递参数到Listener。


四、图标菜单
  // 子菜单项不支持显示图标，这样做是没意义的，尽管不会报错！
    menuitem1.setIcon(R.drawable.displaysettings);
    
    //但是子菜单本身是支持图标的
    subMenu.setIcon(R.drawable.settings);
  菜单的前面可以有个图标，后文的代码中，不再具体演示用法。


五、Context Menu
上下文菜单与Options Menu最大的不同在于，Options Menu的拥有者是Activity，而上下文菜单的拥有者是Activity中的View。
每个Activity有且只有一个Options Menu，它为整个Activity服务。
而一个Activity往往有多个View，并不是每个View都有上下文菜单，这就需要我们显示地通过registerForContextMenu(View view)来指定。


尽管上下文菜单的拥有者是View，生成上下文菜单却是通过Activity中的onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo)方法，
该方法很像生成Options Menu的onCreateOptionsMenu(Menu menu)方法。
两者的不同在于，onCreateOptionsMenu只在用户第一次按“Menu”键时被调用，而onCreateContextMenu会在用户每一次长按View时被调用，而且View必须已经注册了上下文菜单。


另一个值得注意的就是上图中的ContextMenuInfo，该类的对象被传入onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo)方法，那么它有什么用呢？
有时候，视图元素需要向上下文菜单传递一些信息，比如该View对应DB记录的ID等，这就要使用ContextMenuInfo。
需要传递额外信息的View需要重写getContextMenuInfo()方法，返回一个带有数据的ContextMenuInfo实现类对象。


如何创建和响应上下文菜单的3个步骤


1.在activity的onCreate(...)方法中为一个view注册上下文菜单。


2.在onCreateContextMenuInfo(...)中生成上下文菜单。


3.在onContextItemSelected(...)中响应上下文菜单项。 


六、代码示例
需要说明的是，Option Menu，按左键菜单或者右键菜单按钮，弹出菜单。
Context Menu,长按View，弹出菜单。


OptionMenu代码

package cn.fansunion.menu;


import cn.fansunion.R;
import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.view.SubMenu;
import android.widget.Toast;


/**
 * ①：直接去覆盖public boolean onCreateOptionsMenu(Menu menu) { code......}，
 * 这个方法，需要注意的是，这个方法如果覆盖的了，只会被创建一次，也就是说， 选项菜单只会去被实例化一次，之后就不会被去调用了
 * ②：调用Menu中的add（）方法，来添加每一个菜单选项, add(groupId, itemId, order, titleRes) group:
 * 选项组号，一般都设置成0就OK啦 itenId: 选项的Id 很重要 order:顺序，一般来说都设置0就行了 titelRes: 选项的标题名字
 * ③：当我们去点击某项的选项的时候，覆盖重写onOptionsItemSelected(MenuItem item)这个方法去实现点击事件.
 */
public class OptionMenuActivity extends Activity {
	// 点击菜单选项的常量Id
	private static final int MENU_ONE = 1;
	private static final int MENU_TWO = 2;
	private static final int MENU_THREE = 3;
	private int MENU_SUB = 11;
	private static final  int GROUP_ZERO = 0;
	
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.option_menu);


	}


	/**
	 * @param group
	 *            : 选项组号，一般都设置成0就OK啦
	 * @param itenId
	 *            : 选项的Id 很重要
	 * @param order
	 *            :顺序，一般来说都设置0就行了
	 * @param titelRes
	 *            : 选项的标题名字
	 */
	public boolean onCreateOptionsMenu(Menu menu) {	
		menu.add(GROUP_ZERO, MENU_ONE, GROUP_ZERO, "小雷");
		// 一个menu可以包括多个子菜单
		SubMenu subMenu=menu.addSubMenu(GROUP_ZERO, MENU_SUB, GROUP_ZERO, "小雷兴趣");
		subMenu.add(GROUP_ZERO, MENU_TWO, GROUP_ZERO, "互联网技术");
		subMenu.add(GROUP_ZERO, MENU_THREE, GROUP_ZERO, "投资理财");
		return true;


	}


	/**
	 * 
	 * @param item
	 *            .getItemId() 获取被点击的Id
	 */
	public boolean onOptionsItemSelected(MenuItem item) {
		switch (item.getItemId()) {
		case MENU_ONE:
			Toast.makeText(this, "你点击了Menu1", Toast.LENGTH_LONG).show();
			break;
		case MENU_TWO:
			Toast.makeText(this, "你点击了Menu2", Toast.LENGTH_LONG).show();
			break;
		case MENU_THREE:
			Toast.makeText(this, "你点击了Menu3", Toast.LENGTH_LONG).show();
			break;
		
		default:
			return super.onOptionsItemSelected(item);
		}
		return true;
	}
}

布局文件layout
option_menu.xml

<?xml version="1.0" encoding="utf-8"?>  
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    android:orientation="vertical"  
    android:layout_width="fill_parent"  
    android:layout_height="fill_parent"  
    >  
    <TextView    
       android:layout_width="fill_parent"   
       android:layout_height="wrap_content"   
       android:text="FansUnion,Android Demo "/>  
   
</LinearLayout>  

ContextMenu代码

package cn.fansunion.menu;
import cn.fansunion.R;
import android.app.Activity;  
import android.os.Bundle;  
import android.view.ContextMenu;  
import android.view.ContextMenu.ContextMenuInfo;  
import android.view.MenuItem;  
import android.view.View;  
import android.widget.TextView;  
import android.widget.Toast;  
  
public class ContextMenuActivity extends Activity {  
    private static final int GROUP = 0;
	private static final int MENU_ONE = 1;  
    private static final int MENU_TWO = 2;  
    private static final int MENU_THREE = 3;  
  
    private TextView contextView;  
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.context_menu);  
        contextView = (TextView) this.findViewById(R.id.contextMenu);  
        registerForContextMenu(contextView);  
    }  
  
    @Override  
    public void onCreateContextMenu(ContextMenu menu, View v,  
            ContextMenuInfo menuInfo) {  
        super.onCreateContextMenu(menu, v, menuInfo);  
        menu.add(GROUP, MENU_ONE, 0, "小雷FansUnion");  
        menu.add(GROUP, MENU_TWO, 0, "互联网技术");  
        menu.add(GROUP, MENU_THREE, 0, "投资理财");  
    }  
  
    @Override  
    public boolean onContextItemSelected(MenuItem item) {  
        switch (item.getItemId()) {  
        case MENU_ONE:  
            Toast.makeText(this, "你 点击的是Menu1", Toast.LENGTH_LONG).show();  
            contextView.setText("你点击的是Menu1");  
            break;  
  
        case MENU_TWO:  
            Toast.makeText(this, "你点击的是Menu2", Toast.LENGTH_LONG).show();  
            contextView.setText("你点击的是Menu2");  
            break;  
        case MENU_THREE:  
            Toast.makeText(this, "你点击的是Menu3", Toast.LENGTH_LONG).show();  
            contextView.setText("你点击的是Menu3");  
            break;  
        }  
        return true;  
    }  
}  

布局layout
context_menu.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:orientation="vertical" android:layout_width="fill_parent"
	android:layout_height="fill_parent">
	 <TextView    
	   android:id="@+id/contextMenu"  
       android:layout_width="fill_parent"   
       android:layout_height="wrap_content"   
       android:text="FansUnion,ContextMenuDemo "/>  
</LinearLayout>	

  注：本文主要是根据以下3个地方的参考资料，简化和优化了文字和代码，改造而来的。
  
参考资料  
  http://www.cnblogs.com/codingmyworld/archive/2011/08/21/2147829.html(5篇很不错，最佳参考资料）
  http://nullpointsun.iteye.com/blog/1589850（中规中矩，1篇长的）
  http://www.linuxidc.com/Linux/2011-12/49593.htm（马马虎虎，3篇短的）