Pro Android学习笔记(三三):Menu(4):Alternative菜单
什么是Alternative menu(替代菜單)
舉個例子,Activity顯示一個文本文件。如果用戶想對文本文件進行編輯,Activity不提供編輯能力,但可由其他activity或者其他應用提供。我們將相關信息存儲在一個intent中,例如該文本的Uri。這個intent可以匹配系統的多個應用,替代菜單將這些應用一一列出,菜單項的title就是該可被調用的activity的名字,圖標也為該可被調用的activity的圖表。
小例子說明
我們通過一個小例子進行學習,簡單地打開一個URL:wei://flowingflying/helloworld。在之前Intent的學習中,我們通過schema的配置,匹配該URL,也就是我們已經有其他應用的Activity(Intent Basic Test)可以打開該URL。我們同時在App中新增一個activity也能打開該URL。這樣,將在alternative菜單中加入兩個菜單項,點擊它們,將打開相應的activity,并通過intent傳遞相關的數據信息。
新增的acitivity名字為Invoke Action(好像應該是invoked才對,不好意思)。在AndroidManifest.xml中加入intent-fliter的描述即可,具體見:Pro Android學習筆記(十一):了解Intent(中)?。
<activity android:name=".InvokeAction" android:label="@string/invokeAction" android:icon="@drawable/leaf" >
??? <intent-filter >?
??????? <action android:name="android.intent.action.VIEW"?/>?
????????<data android:scheme="wei" />?
??????? <category android:name="android.intent.category.DEFAULT" />?
??????? <category android:name="android.intent.category.ALTERNATIVE" /><!-- 將在最后討論 -->
??? </intent-filter>?
</activity>?
Alternative menu代碼
我們看看如何將替代菜單加入到OptionMenu中。Alternative menu還可以加載subMenu,Context Menu中。
@Override?
public boolean onCreateOptionsMenu(Menu menu) {?
????// 對比:加入一個普通菜單項??
????menu.add("普通菜單項");??
????//【步驟1】設置intent,本例簡單實用一個已知的Uri。
??? Intent menuIntent = new Intent(null,Uri.parse("wei://flowingflying/helloWorld"));?
????//【步驟2】加入Alternative菜單。在之前的Item ID類別中已經講過,Android對ID進行了劃分,有alternative的ID范圍。
??? int menuGroup = Menu.CATEGORY_ALTERNATIVE;?
??? int startingItemId =?Menu.CATEGORY_ALTERNATIVE;?
??? int orderId = Menu.CATEGORY_ALTERNATIVE;??
??? menu.addIntentOptions(??//返回增加的菜單項數目,本例為2
??????????? menuGroup,??/* int groupId */?
??????????? startingItemId,??/* int itemId:由于自動跳轉到,此參數可以設置為Menu.NONE。 */
??????????? orderId,???/*int order*/?
??????????? this.getComponentName(),?/* ComponentName caller:當前的activity名字,這是android系統處理alternatice menu是調用的queryIntentActivityOptions()函數所需要的參數。getComponentName()返回package名字和class名字,系統以此獲知源activity是誰。 */
??????????? null,??/* Intent[] specifics:匹配可能有多個intent,此用于過濾,但具體用途不詳 */
??????????? menuIntent,??/* Intent intent:關鍵的intent */
??????????? 0,??/* flages:關于items如何加入。0表示 no flag*/
??????????? null);??/* MenuItem[] outSpecificItems ,與specifice相關*/
????return super.onCreateOptionsMenu(menu);?
}?
關于Category和規范代碼寫法
我們注意到,在被喚起的actvity中有下面的描述:
[html]?view plaincopy在試驗中,發現此項可有可無,并不真正影響結果。而在reference中卻明確表示要為CATEGORY_ALTERNATIVE或者CATEGORY_SELECTED_ALTERNATIVE。為何?
我們以Alternative menu的方式調用其他activity,正規的做法是,被喚起的activity應允許被alternative菜單喚起。因此被喚起的activity在intent-fliter中需給出類別。同時alternative菜單的intent也應當標明自己類型。因此規范的代碼是:
Intent menuIntent = new Intent(null,this.getIntent().getData());?
menuIntent.addCategory(Intent.CATEGORY_ALTERNATIVE);?
在小例子中,由于其他應用的Activity(Intent Basic Test)在Manifest XML中并沒有給出相應的類別,不被匹配。運行結果如圖:
關于flags
menu.addIntentOptions()的倒數第二個參數是flags,表示菜單項添加的方式。0,即缺省,表示如果groupId相同,則替代菜單將取代原有的菜單項設置。如果我們想保留原有的同一Group的菜單項,可以將flags設置為Menu.FLAG_APPEND_TO_GROUP。注意,如果groupId為Menu.NONE是不進行替換的,這個表示不設置GroupId,并非GroupId為0。
多個匹配的itemId等參數
讓我們看看系統是如何實現Alternative菜單的。從reference中看到,Menu是一個interface,具體是通過MenuBuilder實現(源代碼見android-17(version)/com/android/internal/view/menu/MenuBuilder.java。相關代碼如下:
public int addIntentOptions(int group, int id, int categoryOrder, ComponentName caller,
??????? Intent[] specifics, Intent intent, int flags, MenuItem[] outSpecificItems) {
??? PackageManager pm = mContext.getPackageManager();?
??? final List<ResolveInfo> lri =??//查詢匹配的Activity信息?
??????????? pm.queryIntentActivityOptions(caller, specifics, intent, 0);?
????final int N = lri != null ? lri.size() : 0;
????//下面說明如果flag表示FLAG_APPEND_TO_GROUP,會刪除整個group,取而代之
??? if ((flags & FLAG_APPEND_TO_GROUP) == 0) {?
??????? removeGroup(group);?
??? }?
??? for (int i=0; i<N; i++) {?
??????? final ResolveInfo ri = lri.get(i);?
??????? Intent rintent = new Intent(?
??????????? ri.specificIndex < 0 ? intent : specifics[ri.specificIndex]);?
??????? rintent.setComponent(new ComponentName(?
??????????????? ri.activityInfo.applicationInfo.packageName,?
??????????????? ri.activityInfo.name));?
????????final MenuItem item = add(group, id, categoryOrder, ri.loadLabel(pm))
??????????????? .setIcon(ri.loadIcon(pm))?
??????????????? .setIntent(rintent);?
??????? if (outSpecificItems != null && ri.specificIndex >= 0) {
??????????? outSpecificItems[ri.specificIndex] = item;?
??????? }?
??? }?
??? return N;?
}?
從源代碼,可能看出如果有多個匹配,這些菜單項具有相同的group,相同的id,和相同categoryOrder。雖然我們在小例子中使用了startingItemId,但是實際上itemId是相同的。在小例子中,我們增加了public boolean onOptionsItemSelected(MenuItem item),并在里面檢查item的參數值,證實確實相同。
這段代碼還說明了菜單項的名字和圖片為何,以及為何能喚起Activity。采用了setIntent(),是在Pro Android學習筆記(三十):Menu(1):了解Menu學習過的的一種觸發機制。
本博文涉及的例子代碼,可以在Pro Android學習:Menu中下載。
轉載于:https://www.cnblogs.com/mzsoft/p/4467780.html
總結
以上是生活随笔為你收集整理的Pro Android学习笔记(三三):Menu(4):Alternative菜单的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 设计模式之禅读书笔记
- 下一篇: android sina oauth2.