android menu.addIntentOptions 添加动态菜单

 

android的一个activity可以再选中某项之后按menu键弹出特定的菜单,也就是动态菜单。
动态菜单的实现是靠menu类中的addIntentOptions函数实现的，具体的声明如下：
int android.view.Menu.addIntentOptions(   
int groupId,   
int itemId,   
int order,   
ComponentName caller,   
Intent[] specifics,   
Intent intent,   
int flags,   
MenuItem[] outSpecificItems)  
int android.view.Menu.addIntentOptions(
int groupId,
int itemId,
int order,
ComponentName caller,
Intent[] specifics,
Intent intent,
int flags,
MenuItem[] outSpecificItems) 
这个函数是用来动态产生option menu的

函数参数分析：

1.groupid  就是菜单组的编号；

2.itemId   (可以让其为0)

3.order     菜单顺序，可以不考虑

4.Caller      就是发起activity的activity

5.Specifics  以action+uri的具体方式来增加激活相应activity的菜单项

6.Intent      以categroy+uri这种一般形式来增加激活相应activity的菜单项

参数Intent和Specifics的区别是，一个用categroy+uri来匹配activity，一个用action+uri来匹配 activity。

8.outSpecificItems  这个是返回的MenuItem值，对应以specifics方式匹配的菜单项。

下面以android sdk中notepad的例子来说明其用法。

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

 
Uri uri = ContentUris.withAppendedId(getIntent().getData(), getSelectedItemId());    
 
Intent[] specifics = new Intent[1];    
specifics[0] = new Intent(Intent.ACTION_EDIT, uri);    
MenuItem[] items = new MenuItem[1];    
Intent intent = new Intent(null, uri);  
intent.addCategory(Intent.CATEGORY_ALTERNATIVE);  
menu.addIntentOptions(Menu.CATEGORY_ALTERNATIVE, 0, 0, null, specifics, intent, 0,  items);  
Uri uri = ContentUris.withAppendedId(getIntent().getData(), getSelectedItemId());  
Intent[] specifics = new Intent[1];  
specifics[0] = new Intent(Intent.ACTION_EDIT, uri);  
MenuItem[] items = new MenuItem[1];  
Intent intent = new Intent(null, uri);  
intent.addCategory(Intent.CATEGORY_ALTERNATIVE);  
menu.addIntentOptions(Menu.CATEGORY_ALTERNATIVE, 0, 0, null, specifics, intent, 0, items);  

Uri uri = ContentUris.withAppendedId(getIntent().getData(), getSelectedItemId()); 

Intent[] specifics = new Intent[1]; 
specifics[0] = new Intent(Intent.ACTION_EDIT, uri); 
MenuItem[] items = new MenuItem[1]; 
Intent intent = new Intent(null, uri);
intent.addCategory(Intent.CATEGORY_ALTERNATIVE);
menu.addIntentOptions(Menu.CATEGORY_ALTERNATIVE, 0, 0, null, specifics, intent, 0,  items);
Uri uri = ContentUris.withAppendedId(getIntent().getData(), getSelectedItemId());
Intent[] specifics = new Intent[1];
specifics[0] = new Intent(Intent.ACTION_EDIT, uri);
MenuItem[] items = new MenuItem[1];
Intent intent = new Intent(null, uri);
intent.addCategory(Intent.CATEGORY_ALTERNATIVE);
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

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

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

 

写好该activity的layout和实现后，选中noteslist中的一项后，点 menu可以看到菜单中多出了一项，点击可以切换到该activity。

这是以函数中Intent匹配的菜单项，当然也可以用Specifics来匹配。下面示例：

删除掉MyAdd这个activity中的 <category android:name="android.intent.category.ALTERNATIVE" />，这时该activity已经与Intent不匹配了，

再将onPrepareOptionsMenu 函数中的代码改成如下：

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

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

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