zoukankan      html  css  js  c++  java
  • 【转】 Pro Android学习笔记(三三):Menu(4):Alternative菜单

    目录(?)[-]

    1. 什么是Alternative menu替代菜单
    2. 小例子说明
    3. Alternative menu代码
    4. 关于Category和规范代码写法
    5. 关于flags
    6. 多个匹配的itemId等参数

    什么是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
     
    1. <category android:name="android.intent.category.ALTERNATIVE" />  

    在试验中,发现此项可有可无,并不真正影响结果。而在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中下载。

    相关链接: 我的Android开发相关文章

  • 相关阅读:
    书单
    x&(x1)表达式的意义
    约瑟夫环,杀人游戏(静态循环链表实现)
    我的第一个动态规划程序(试图用递归求斐波拉契数)
    NYOJ 2题 括号配对问题
    为什么 C++不叫作++C? o(∩_∩)o
    文字常量区,字符串常量
    括号匹配(栈实现)
    Mybatis的逆向工程(generator)
    Mybatis学习一(介绍/举例/优化)
  • 原文地址:https://www.cnblogs.com/blongfree/p/5047964.html
Copyright © 2011-2022 走看看