menu.addIntentOptions 添加动态菜单

转：http://yueguc.javaeye.com/blog/620407

android的一个activity可以再选中某项之后按menu键弹出特定的菜单,也就是动态菜单。动态菜单的实现是靠menu类中的addIntentOptions函数实现的，具体的声明如下：
int android.view.Menu.addIntentOptions(
            int groupId,              //菜单组的编号
            int itemId,                //itemId   (可以让其为0)
            int order,                 //菜单顺序，可以不考虑 
            ComponentName caller, //发起activity的activity 
            Intent[] specifics,         // 以action+uri的具体方式来增加激活相应activity的菜单项
            Intent intent,              //以categroy+uri这种一般形式来增加激活相应activity的菜单项
            int flags,
            MenuItem[] outSpecificItems) //这个是返回的MenuItem值，对应以specifics方式匹配的菜单项
这个函数是用来动态产生option menu。 
参数Intent和Specifics的区别是，一个用categroy+uri来匹配activity，一个用action+uri来匹配 activity。


下面以android sdk中notepad的例子来说明其用法。
来看这个例子中的NotesList.java 文件中的public boolean onPrepareOptionsMenu(Menu menu)函数,这个函数会在设定普通option menu菜单项的的onCreateOptionsMenu函数之后调用，这个函数的主要部分是如下代码： 

   1. Uri uri = ContentUris.withAppendedId(getIntent().getData(), getSelectedItemId()); 
   2.      
   3.  Intent[] specifics = new Intent[1];  
   4.  specifics[0] = new Intent(Intent.ACTION_EDIT, uri);  
   5.  MenuItem[] items = new MenuItem[1];  
   6.  
   7.  Intent intent = new Intent(null, uri);  
   8.  intent.addCategory(Intent.CATEGORY_ALTERNATIVE);  
   9.  menu.addIntentOptions(Menu.CATEGORY_ALTERNATIVE, 0, 0, null, specifics, intent, 0,  items); 

其中 ContentUris.withAppendedId(getIntent().getData(), getSelectedItemId())会得到选中项的信息，这个信息将会作用匹配用的intent的 data部分。

specifics[0] = new Intent(Intent.ACTION_EDIT, uri)意思是:到androidMenifest.xml中去找activity, 如果有某个activity的<intent- filter>项的action和data与Intent.ACTION_EDIT和相应的uri匹配，就为这个activity添加一个菜单项，菜单项的显示名称从相应 activity的 android:label项得来。

Intent intent = new Intent(null, uri);          
intent.addCategory(Intent.CATEGORY_ALTERNATIVE);

意思是：到androidMenifest.xml中去找activity，如果有某些 activity的<intent-filter>项的Category和data与 Intent.CATEGORY_ALTERNATIVE和相应的uri匹配，就为这些activity分别添加菜单项，菜单项的显示名称从相应activity的android:label项
得来。

下面可以做个试验，在AndroidMenifest.xml中新建一个activity MyAdd 

   1. <activity android:name="MyAdd" android:label="@string/title_myadd" 
   2.         android:windowSoftInputMode="stateVisible"> 
   3.     <intent-filter android:label="@string/resolve_myadd"> 
   4.         <action android:name="com.android.notepad.action.MYADD" /> 
   5.         <category android:name="android.intent.category.ALTERNATIVE" /> 
   6.         <data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> 
   7.     </intent-filter> 
   8. </activity> 

写好该activity的layout和实现后，选中noteslist中的一项后，点 menu可以看到菜单中多出了一项，点击可以切换到该activity。
这是以函数中Intent匹配的菜单项，当然也可以用Specifics来匹配。下面示例删除掉MyAdd这个activity中的 <category android:name="android.intent.category.ALTERNATIVE" />，这时该activity已经与Intent不匹配了，再将onPrepareOptionsMenu 函数中的代码改成如下： 

   1. Intent[] specifics = new Intent[2]; 
   2. specifics[0] = new Intent(Intent.ACTION_VIEW, uri); 
   3. specifics[1] = new Intent("com.android.notepad.action.MYADD",uri); 
   4. MenuItem[] items = new MenuItem[2]; 

选中一项点菜单会发现，动态菜单又回来了，不过这次是用Specific来匹配的。