Android ActionBar的基础使用

这个示例演示了ActionBar的基础使用，包括如何在menu.xml中定义menu items并将其填充到ActionBar的options menu中，以及如何在代码中将menu item添加到给定的options menu中。

介绍##

Android3.0引入了ActionBar，ActionBar可以标识用户所在应用的位置，提供用户在应用的各个Activity间进行切换、导航。示例在运行在Android4.0以上，不支持4.0以下版本。

屏幕截图

basic_actionBar
basic_actionBar2

代码实现

layout/activity_main.xml

<!-- 
    android:textAppearance="?android:attr/textAppearanceMedium"
        基本的文字颜色，字体，大小和样式
    android:paddingRight="@dimen/margin_small"
        文本距离TextView的左边距，这里引用了dimen中定义的margin_small值8dp
    android:paddingLeft="@dimen/margin_small"
        文本距离TextView的右边距，这里引用了dimen中定义的margin_small值8dp
    android:text="@string/intro_message"
        TextView的文本，这里引用了strings.xml中定义的intro_message
    android:layout_width="match_parent"
        TextView的宽度
    android:layout_height="match_parent"
        TextView的高度
    android:gravity="center_vertical"
        设置文本在TextView中的显示方式为垂直居中
 -->
<TextView
    android:paddingRight="@dimen/margin_small"
    android:paddingLeft="@dimen/margin_small"
    android:text="@string/intro_message"
    android:textAppearance="?android:attr/textAppearanceMedium"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center_vertical" />

values/dimens.xml

<resources>
    <!-- 定义标准的margin值 -->
    <dimen name="margin_tiny">4dp</dimen>
    <dimen name="margin_small">8dp</dimen>
    <dimen name="margin_medium">16dp</dimen>
    <dimen name="margin_large">32dp</dimen>
    <dimen name="margin_hurge">64dp</dimen>
    
    <!-- Default screen margins, per the Android Design guidelines. -->
    <dimen name="activity_horizontal_margin">16dp</dimen>
    <dimen name="activity_vertical_margin">16dp</dimen>

</resources>

values/ids.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 为menu_location生成一个唯一的id -->
    <item name="menu_location" type="id"></item>
</resources>

values/strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="app_name">BasicActionBar</string>
    <string name="hello_world">Hello world!</string>
    <string name="menu_settings">设置</string>

    <!--
        CDATA区中的文本将作为普通文本，即使有XML标签。
    -->
    <string name="intro_message">
        
        <![CDATA[
                
            这个示例演示Action Bar的基础使用，包括如何在menu.xml中添加menuItem和
            如何在onCreateOptionsMenu(Menu menu)方法中用Java代码添加menuItem。
            
        ]]>
    </string>
    <string name="menu_refresh">刷新</string>
    <string name="menu_location">位置</string>
</resources>

menu/main.xml

<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:context="com.ddzj.basicactionbar.MainActivity" >

    <!-- 
          刷新Item
        android:id="@+id/action_refresh"
            为该item添加id
        android:showAsAction="ifRoom"
            设置如果ActionBar上有空间的话就在ActionBar上显示，否则在overflow中显示
        android:title="@string/menu_refresh"
            设置该item的标题属性，这里引用了strings.xml中定义的menu_refresh
        android:icon="@drawable/ic_action_refresh"
            设置该item的icon图标，这里引用了drawable下的ic_action_refresh
     -->
    <item
        android:id="@+id/action_refresh"
        android:showAsAction="ifRoom"
        android:title="@string/menu_refresh"
        android:icon="@drawable/ic_action_refresh"
        />
    
    <!-- 我们将在代码中添加定位item -->
    
    <!-- 
    设置item：
        android:id="@+id/action_settings"
            为该item添加id
        android:title="@string/menu_settings"
            该item的标题
        android:icon="@drawable/ic_action_settings"
            该item的icon
        android:showAsAction="never"
            总是在overflow中显示
     -->
    <item 
        android:id="@+id/action_settings"
        android:title="@string/menu_settings"
        android:icon="@drawable/ic_action_settings"
        android:showAsAction="never"
        />

</menu>

MainActivity.java

package com.ddzj.basicactionbar;

import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    /*
     * 初始化Activity的标准选择菜单中的内容，在这个方法中将menu items添加到menu中。 这个方法只在选择菜单（options
     * menu）第一次被显示出来的时候调用一次。要在该菜单每次显示的时候更新它，请参见onPrepareOptionsMenu方法。
     * 
     * 参数：
     *  menu:将menu items放入其中的options menu. 
     * 
     * 返回: 要让菜单显示，你必须返回true，否则不显示
     */
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // 将在menu.xml中定义好的menu items填充到menu中。inflate--填充
        getMenuInflater().inflate(R.menu.main, menu);

        /*
         * 使用代码手动添加定位item
         * 
         * add(int groupId, int itemId, int order, CharSequence title)
         * 这个方法将一个menu item添加到给定menu中。 
         * 
         * 参数:
         * groupId:该item所属的group的group标识符。如果没有所属，则写Menu.NONE 
         * itemId: 该item的Id.如果不需要一个唯一的ID，则写Menu.NONE,因为我们要处理该item的点击事件，
         *          因此需要一个唯一的id来标示，我们在values/ids.xml中为该item定义一个id.
         * order: 如果不关心顺序，则写Menu.NONE. 参见MenuItem.getOrder() 
         * title: 该item显示的文字
         */
        MenuItem locationItem = menu.add(Menu.NONE, R.id.menu_location, Menu.NONE, R.string.menu_location);
        locationItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
        locationItem.setIcon(R.drawable.ic_action_location);
        return true;
    }

    /*
     * 当你的options menu中的menu item被点击时，调用此函数。hook：回调函数、钩子 
     * 参数: 
     *      item：被点击的menu item
     */
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {

        switch (item.getItemId()) {
        case R.id.action_refresh:
            // 处理刷新的代码
            return true;
        case R.id.menu_location:
            // 处理定位的代码
            return true;
        case R.id.action_settings:
            // 处理设置的代码
            return true;
        }
        // 总是调用该方法来做默认的处理
        return super.onOptionsItemSelected(item);
    }
}

图片资源##

ic_action_location.png
ic_action_refresh.png
ic_action_settings.png
ic_launcher.png