【起航计划 023】2015 起航计划 Android APIDemo的魔鬼步伐 22 App->Menu->Inflate from XML 使用xml资源展示菜单

本例MenuInflateFromXml.java演示了如何从Menu 资源（XML 定义）展开菜单项。这个例子的onCreate 采用了使用代码来创建Activity 界面的方法 而通常的方法是采用Layout资源的方法。如果你有兴趣了解一下如何使用代码创建UI，可以参考本例的onCreate方法，但这不是本例的演示目的。

        // 1.创建LinearLayout布局 Create a simple layout
　　　　 LinearLayout layout = new LinearLayout(this);
        layout.setOrientation(LinearLayout.VERTICAL);
        
        // 2.创建一个spinner Create the spinner to allow the user to choose a menu XML
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
                android.R.layout.simple_spinner_item, sMenuExampleNames); 
        adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
        mSpinner = new Spinner(this);
        // When programmatically creating views, make sure to set an ID
        // so it will automatically save its instance state
        mSpinner.setId(R.id.spinner);
        mSpinner.setAdapter(adapter);
        mSpinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
            @Override
            public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
                invalidateOptionsMenu();
            }
            @Override
            public void onNothingSelected(AdapterView<?> parent) {
            }
        });
        
        // 3.添加spinner到布局中Add the spinner
        layout.addView(mSpinner,
                new LinearLayout.LayoutParams(
                        LinearLayout.LayoutParams.MATCH_PARENT,
                        LinearLayout.LayoutParams.WRAP_CONTENT));

        // 4.创建一个TextView Create help text
        mInstructionsText = new TextView(this);
        mInstructionsText.setText(getResources().getString(
                R.string.menu_from_xml_instructions_press_menu));
        
        // 5.添加TextView到布局中 Add the help, make it look decent
        LinearLayout.LayoutParams lp = new LinearLayout.LayoutParams(
                LinearLayout.LayoutParams.MATCH_PARENT,
                LinearLayout.LayoutParams.WRAP_CONTENT);
        lp.setMargins(10, 10, 10, 10);
        layout.addView(mInstructionsText, lp);
        
        // 6.Set the layout as our content view
        setContentView(layout);

使用XML 菜单资源来展开菜单的一般步骤是

1. 在/res/menu目录下定义菜单资源，本例中定义了10种不同风格的菜单项：”Title only”, “Title and Icon”, “Submenu”, “Groups”,”Checkable”, “Shortcuts”, “Order”, “Category and Order”,”Visible”, “Disabled”。

最简单的Menu资源定义如下：只包括id 和title 定义。

<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:id="@+id/jump"
        android:title="@string/jump" />

    <item android:id="@+id/dive"
        android:title="@string/dive" />

</menu>

2. 展开菜单资源，Android支持两大类菜单Option Menu(主菜单）,Context Menu  （上下文相关菜单）。本例使用Option Menu ,可以在public boolean onCreateOptionsMenu(Menu menu) 方法中使用MenuInflater 展开菜单资源：

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Hold on to this
        mMenu = menu;
        
        // Inflate the currently selected menu XML resource.
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(sMenuExampleResources[mSpinner.getSelectedItemPosition()], menu);
        
        // Change instructions
        mInstructionsText.setText(getResources().getString(
                R.string.menu_from_xml_instructions_go_back));
        
        return true;
    }

3. 为菜单添加处理事件的方法。

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        switch (item.getItemId()) {
            // For "Title only": Examples of matching an ID with one assigned in
            //                   the XML
            case R.id.jump:
                Toast.makeText(this, "Jump up in the air!", Toast.LENGTH_SHORT).show();
                invalidateOptionsMenu();　　//调用这个方法，原来的菜单项将无效
                return true;

            case R.id.dive:
                Toast.makeText(this, "Dive into the water!", Toast.LENGTH_SHORT).show();
                return true;

            // For "Groups": Toggle visibility of grouped menu items with
            //               nongrouped menu items
            case R.id.browser_visibility:
                // The refresh item is part of the browser group
                final boolean shouldShowBrowser = !mMenu.findItem(R.id.refresh).isVisible();
                mMenu.setGroupVisible(R.id.browser, shouldShowBrowser);
                break;
                
            case R.id.email_visibility:
                // The reply item is part of the email group
                final boolean shouldShowEmail = !mMenu.findItem(R.id.reply).isVisible();
                mMenu.setGroupVisible(R.id.email, shouldShowEmail);
                break;
                
            // Generic catch all for all the other menu resources
            default:
                // Don't toast text when a submenu is clicked
                if (!item.hasSubMenu()) {
                    Toast.makeText(this, item.getTitle(), Toast.LENGTH_SHORT).show();
                    return true;
                }
                break;
        }
        
        return false;
    }

但用户选择某个菜单时将触发onOptionsItemSelected 事件，参数item为用户选择的Menu Item，可以根据Menu 的 Id来实现菜单项对应的操作。

本例菜单使用10种不同的风格，基本使用方法是都是一样的，不同是定义在XML item的属性。

Title only

最简单的菜单，菜单只含有文本描述。

Title and Icon

菜单含有文字和图标。增加android:icon属性。

    <item android:id="@+id/happy"
        android:title="Happy"
        android:icon="@drawable/stat_happy" />

Sub Menu

尽管在手机使用多层菜单的可能性不大，但如果想使用sub Menu的话，Android 也可以支持多次菜单，这是通过嵌套定义Menu Item的方法来实现的：

<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:title="Normal 1" />

    <item android:id="@+id/submenu"
        android:title="Emotions">

        <menu>        

            <item android:id="@+id/happy"
                android:title="Happy"
                android:icon="@drawable/stat_happy" />
        
            <item android:id="@+id/neutral"
                android:title="Neutral"
                android:icon="@drawable/stat_neutral" />
        
            <item android:id="@+id/sad"
                android:title="Sad"
                android:icon="@drawable/stat_sad" />
        
        </menu>
    
    </item>

    <item android:title="Normal 2" />

</menu>

Groups

Menu定义上可以将一些相关的菜单定义为一个组，同组的菜单项可以定义一些相同的属性，比如可以使用setGroupVisible设置组内所有成员是否可见，setGroupEnabled可以组内所有成员是否有效等。组的定义是使用group来定义：

    <group android:id="@+id/browser">
    
        <item android:id="@+id/refresh"
            android:title="@string/browser_refresh" />
    
        <item android:id="@+id/bookmark"
            android:title="@string/browser_bookmark" />
    
    </group>

组可以定义id，比如想将菜单组的可见性可以使用：

                // The refresh item is part of the browser group
                final boolean shouldShowBrowser = !mMenu.findItem(R.id.refresh).isVisible();
                mMenu.setGroupVisible(R.id.browser, shouldShowBrowser);

Checkable

对应定义了组的Menu Item可以定义组的checkable ，组内item可以继承组的checkable 属性，不在组内的item可以单独定义自己的checkable属性，定义了checkable属性的菜单将会以Check button或是Radio Button的风格显示：

checkable 定义了四种不同风格的checkableBehavior:

    <item android:title="None">
        <menu>
            <!-- The none checkableBehavior is default, but we explicitly show it here. -->
            <group android:id="@+id/noncheckable_group"
                    android:checkableBehavior="none">
                <!-- Notice how these items inherit from the group. -->
                <item android:id="@+id/noncheckable_item_1"
                        android:title="@string/item_1" />
                <item android:id="@+id/noncheckable_item_2"
                        android:title="@string/item_2" />
                <item android:id="@+id/noncheckable_item_3"
                        android:title="@string/item_3" />
            </group>
        </menu>
    </item>

    <item android:title="All">
        <menu>
            <group android:id="@+id/checkable_group"
                    android:checkableBehavior="all">
                <!-- Notice how these items inherit from the group. -->
                <item android:id="@+id/checkable_item_1"
                        android:title="@string/item_1" />
                <item android:id="@+id/checkable_item_2"
                        android:title="@string/item_2"
                        android:checked="true" />
                <item android:id="@+id/checkable_item_3"
                        android:title="@string/item_3"
                        android:checked="true" />
            </group>
        </menu>
    </item>

    <item android:title="Single">
        <menu>
            <group android:id="@+id/exclusive_checkable_group"
                    android:checkableBehavior="single">
                <!-- Notice how these items inherit from the group. -->
                <item android:id="@+id/exclusive_checkable_item_1"
                        android:title="@string/item_1" />
                <item android:id="@+id/exclusive_checkable_item_2"
                        android:title="@string/item_2" />
                <item android:id="@+id/exclusive_checkable_item_3"
                        android:title="@string/item_3"
                        android:checked="true" />
            </group>
        </menu>
    </item>

    <item android:title="All without group">
        <menu>
            <!-- Notice how these items have each set. -->
            <item android:id="@+id/nongroup_checkable_item_1"
                    android:title="@string/item_1"
                    android:checkable="true" />
            <item android:id="@+id/nongroup_checkable_item_2"
                    android:title="@string/item_2"
                    android:checkable="true"
                    android:checked="true" />
            <item android:id="@+id/nongroup_checkable_item_3"
                    android:title="@string/item_3"
                    android:checkable="true"
                    android:checked="true" />
        </menu>
    </item>

Shortcuts

菜单项可以添加快捷键属性，比如按下”i”键，触发菜单项invisible_item。

    <item android:id="@+id/invisible_item"
        android:visible="false"
        android:alphabeticShortcut="i"
        android:title="Invisible item" />

在显示菜单时，由于多于6个菜单选项，h_item在按More时才会显示，但h_item定义了一个快捷键“h”，此时直接按”h”，会立即触发h_item菜单项。

Order

对应定义的菜单项，缺省显示的方法和定义的顺序一致，但可以使用android:orderInCategory属性重新定义菜单显示的属性。比如 下面定义的属性为fouth,third,second,first 而orderInCategory为3，2，1，0.则实际的菜单显示顺序如下图：

    <item android:id="@+id/fourth_item"
        android:orderInCategory="3"
        android:title="Fourth" />

    <item android:id="@+id/third_item"
        android:orderInCategory="2"
        android:title="Third" />

    <item android:id="@+id/second_item"
        android:orderInCategory="1"
        android:title="Second" />

    <item android:id="@+id/first_item"
        android:orderInCategory="0"
        android:title="First" />

Category and Order

除了缺省的category ，也可以再定义其它的次要的Category，每个Category可以分别再为每个Menu Item定义它们的android:orderInCategory，最后菜单项显示的顺序是 ：按orderInCategory顺序显示缺省Category的所有菜单项，接着在按orderInCategory顺序显示次要Category中 的菜单项：比如category_order.xml有如下定义：

    <!-- This group uses the default category. -->
    <group android:id="@+id/most_used_items">
    
        <item android:id="@+id/last_most_item"
            android:orderInCategory="10"
            android:title="@string/last_most_often" />
    
        <item android:id="@+id/middle_most_item"
            android:orderInCategory="7"
            android:title="@string/middle_most_often" />
    
        <item android:id="@+id/first_most_item"
            android:orderInCategory="4"
            android:title="@string/first_most_often" />
    
    </group>
    
    <group android:id="@+id/least_used_items"
        android:menuCategory="secondary">
        
        <item android:id="@+id/last_least_item"
            android:orderInCategory="3"
            android:title="@string/last_least_often" />
    
        <item android:id="@+id/middle_least_item"
            android:orderInCategory="2"
            android:title="@string/middle_least_often" />
    
        <item android:id="@+id/first_least_item"
            android:orderInCategory="0"
            android:title="@string/first_least_often" />
    
    </group>

先group,再item

最后的菜单显示顺序如下：

Visible

MenuItem 具有一个android:visible属性，缺省为true,如果定义为“false”，即使在XML定义了该菜单项，最后也不会显示。

    <item android:id="@+id/visible_item"
        android:title="Visible"
        android:alphabeticShortcut="a" />

    <item android:id="@+id/hidden_item"
        android:title="Hidden"
        android:visible="false"
        android:alphabeticShortcut="b" />

Disabled

除了visable属性外，还可以指定enabled属性，enabled属性缺省为true，表示该菜单项有效，为false时，表示还菜单项无效，一般为显示为灰色。

    <item android:id="@+id/enabled_item"
        android:title="Enabled"
        android:icon="@drawable/stat_happy" />

    <item android:id="@+id/disabled_item"
        android:title="Disabled"
        android:enabled="false"
        android:icon="@drawable/stat_sad" />