ActionBar-2

转载地址：http://blog.csdn.net/xyz_lmn/article/details/8132420

添加导航选项标签

       当你想要在一个Activity中提供导航选择标签时，使用操作栏的选项标签是一个非常好的选择（而不是使用TabWidget类），因为系统会调整操作栏选项标签来适应不同尺寸的屏幕的需要---在屏幕足够宽的时候，导航选项标签会被放到主操作栏中；当屏幕太窄的时候，选项标签会被放到一个分离的横条中，如图9和图10所示。

      

图9. Honeycomb Gallery应用程序中的操作栏选项标签的截图

      

          图10. 在窄屏设备上被堆放在操作栏中的选项标签的截屏 

       要使用选项标签在Fragmengt之间切换，你必须在每次选择一个选项标签时执行一个Fragment事务。如果你不熟悉如何使用FragmentTransaction对象来改变Fragment，请阅读Fragment开发指南。

       首先，你的布局必须包含一个用于放置跟每个Fragment对象关联的选项标签的ViewGroup对象。并且要确保这个ViewGroup对象有一个资源ID，以便你能够在选项标签的切换代码中能够引用它。另外，如果选项标签的内容填充在Activity的布局中（不包括操作栏），那么Activity不需要任何布局（你甚至不需要调用setContentView()方法）。相反，你能够把每个Fragment对象放到默认的根ViewGroup对象中，你能够用android.R.id.content ID来引用这个ViewGroup对象（在Fragment执行事务期间，你能够在下面的示例代码中看到如何使用这个ID的。

        决定了Fragment对象在布局中的显示位置后，添加选项标签的基本过程如下：

          1.  实现ActionBar.TabListener接口。这个接口中回调方法会响应选项标签上的用户事件，以便你能够切换Fragment对象；

           2.  对于每个要添加的选项标签，都要实例化一个ActionBar.Tab对象，并且调用setTabListener()方法设置ActionBar.Tab对象的事件监听器。还可以用setText()或setIcon()方法来设置选项标签的标题或图标。

         3.  通过调用addTab()方法，把每个选项标签添加到操作栏。

        在查看ActionBar.TabListener接口时，注意到回调方法只提供了被选择的ActionBar.Tab对象和执行Fragment对象事务的FragmentTransaction对象---没有说明任何有关Fragment切换的事。因此。你必须定义自己的每个ActionBar.Tab之间的关联，以及ActionBar.Tab所代表的适合的Fragment对象（为了执行合适的Fragment事务）。依赖你的设计，会有几种不同的方法来定义这种关联。在下面的例子中，ActionBar.TabListener接口的实现提供了一个构造器，这样每个新的选项标签都会使用它自己的监听器实例。每个监听器实例都定义了几个在对应Fragment对象上执行事务时必须的几个成员变量。

       例如，以下示例是ActionBar.TabListener接口的一种实现，在这个实现中，每个选项标签都使用了它自己的监听器实例：

public static class TabListener<T extends Fragment> implements ActionBar.TabListener {
    private Fragment mFragment;
    private final Activity mActivity;
    private final String mTag;
    private final Class<T> mClass;

    /** Constructor used each time a new tab is created.
      * @param activity  The host Activity, used to instantiate the fragment
      * @param tag  The identifier tag for the fragment
      * @param clz  The fragment's Class, used to instantiate the fragment
      */
    public TabListener(Activity activity, String tag, Class<T> clz) {
        mActivity = activity;
        mTag = tag;
        mClass = clz;
    }

    /* The following are each of the ActionBar.TabListener callbacks */

    public void onTabSelected(Tab tab, FragmentTransaction ft) {
        // Check if the fragment is already initialized
        if (mFragment == null) {
            // If not, instantiate and add it to the activity
            mFragment = Fragment.instantiate(mActivity, mClass.getName());
            ft.add(android.R.id.content, mFragment, mTag);
        } else {
            // If it exists, simply attach it in order to show it
            ft.attach(mFragment);
        }
    }

    public void onTabUnselected(Tab tab, FragmentTransaction ft) {
        if (mFragment != null) {
            // Detach the fragment, because another one is being attached
            ft.detach(mFragment);
        }
    }

    public void onTabReselected(Tab tab, FragmentTransaction ft) {
        // User selected the already selected tab. Usually do nothing.
    }
}

       警告：针对每个回调中的Fragment事务，你都不必调用commit()方法---系统会调用这个方法，并且如果你自己调用了这个方法，有可能会抛出一个异常。你也不能把这些Fragment事务添加到回退堆栈中。

在这个例子中，当对应的选项标签被选择时，监听器只是简单的把一个Fragment对象附加（attach()方法）到Activity布局上---或者，如果没有实例化，就会创建这个Fragment对象，并且把它添加（add()方法）到布局中（android.R.id.content ViewGroup的一个子类），当这个选项标签解除选择时，对应的Fragment对象也会被解除与布局的依附关系。

       ActionBar.TabListener的实现做了大量的工作，剩下的事情就是创建每个ActionBar.Tab对象并把它添加到ActionBar对象中，另外，你必须调用setNavigationMode(NAVIGATION_MODE_TABS)方法来让选项标签可见。如果选项标签的标题实际指示了当前的View对象，你也可以通过调用setDisplayShowTitleEnabled(false)方法来禁用Activity的标题。

       例如，下面的代码使用上面定义的监听器在操作栏中添加了两个选项标签。

    protected void onCreate(Bundle savedInstanceState) {  

    super.onCreate(savedInstanceState);
    // Notice that setContentView() is not used, because we use the root
    // android.R.id.content as the container for each fragment

    // setup action bar for tabs
    ActionBar actionBar = getActionBar();
    actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);
    actionBar.setDisplayShowTitleEnabled(false);

    Tab tab = actionBar.newTab()
            .setText(R.string.artist)
            .setTabListener(new TabListener<ArtistFragment>(
                    this, "artist", ArtistFragment.class));
    actionBar.addTab(tab);

    tab = actionBar.newTab()
        .setText(R.string.album)
        .setTabListener(new TabListener<AlbumFragment>(
                this, "album", AlbumFragment.class));
    actionBar.addTab(tab);
}

        注意：以上有关ActionBar.TabListener的实现，只是几种可能的技术之一。在API Demos应用中你能够看到更多的这种样式。

        如果Activity终止了，那么你应该保存当前选择的选项标签的状态，以便当用户再次返回时，你能够打开合适的选项标签。在保存状态的时刻，你能够用getSelectedNavigationIndex()方法查询当前的被选择的选项标签。这个方法返回被选择的选项标签的索引位置。

       警告：保存每个Fragment所必须的状态是至关重要的，因为当用户用选项标签在Fragment对象间切换时，它会查看Fragment在离开时样子。

       注意：在某些情况下，Android系统会把操作栏选项标签作为一个下拉列表来显示，以便确保操作栏的最优化显示。

添加下拉式导航

       作为Activity内部的另一种导航（或过滤）模式，操作栏提供了内置的下拉列表。下拉列表能够提供Activity中内容的不同排序模式。

       启用下拉式导航的基本过程如下：

         1.  创建一个给下拉提供可选项目的列表，以及描画列表项目时所使用的布局；

         2.  实现ActionBar.OnNavigationListener回调，在这个回调中定义当用户选择列表中一个项目时所发生的行为；

         3.  用setNavigationMode()方法该操作栏启用导航模式，如：

 
    
    ActionBar actionBar = getActionBar();   
    actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_LIST);
ActionBar actionBar = getActionBar();
actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_LIST);

        4.  用setListNavigationCallbacks()方法给下拉列表设置回调方法，如：

1）actionBar.setListNavigationCallbacks(mSpinnerAdapter, mNavigationCallback);  

这个方法需要SpinnerAdapter和ActionBar.OnNavigationListener对象。下面是 SpinnerAdapter and ActionBar.OnNavigationListener 的例子。

 Example SpinnerAdapter and OnNavigationListener

设置操作栏的样式

       如果你对应用程序中的可视构件进行了定制化的设计，那么你可能也会要对操作栏做一些重新设计，以便跟应用程序的设计匹配。要这样做的话，需要使用Android的样式与主题框架中的一些特殊的样式属性来重新设置操作栏的样式。

       注意：改变外观的背景图片依赖与当前按钮的状态（选择、按下、解除选择），因此你使用的可描画的资源必须是一个可描画的状态列表。

       警告：对于你提供的所有可描画的背景，要确保使用NinePatch类型可描画资源，以便允许图片的拉伸。NinePatch类型的图片应该比40像素高30像素宽的图片要小。

普通的外观

android:windowActionBarOverlay

      这个属性声明了操作栏是否应该覆盖Activity布局，而不是相对Activity的布局位置的偏移。这个属性的默认值是false。

      通常，在屏幕上，操作栏需要它自己的空间，并且把剩下的空间用来填充Activity的布局。当操作栏四覆盖模式时，Activity会使用所有的有效空间，系统会在Activity的上面描画操作栏。如果你想要在操作栏隐藏和显示时，布局中的内容保持固定的尺寸好位置，那么这种覆盖模式是有用的。你也可能只是为了显示效果来使用它，因为你可以给操作栏设置半透明的背景，以便用户依然能够看到操作栏背后的Activity布局。

       注意：默认情况下，Holo主题会用半透明背景来描画操作栏。但是，你能够用自己的样式来修改它，并且默认的情况下，DeviceDefault主题在不同的设备上可能使用不透明的背景。

       覆盖模式被启用时，Activity布局不会感知到操作栏覆盖在它的上面，因此，在操作栏覆盖的区域，最好不要放置一些重要的信息或UI组件。如果适合，你能够引用平台的actionBarSize值来决定操作栏的高度，例如，在XML布局文件中引用这个值。

[html] view plaincopyprint?

<SomeView
    ...
    android:layout_marginTop="?android:attr/actionBarSize" />

       你还能够用getHeight()方法在运行时获取操作栏的高度。如果在Activity生存周期的早期调用这个方法，那么在调用时所反映的操作栏的高度可能不包括被堆放的操作栏（因为导航选项标签）。要看如何在运行时判断操作栏总的高度（包括被堆放的操作栏），请看Honeycomb Gallery示例应用中的TitlesFragment类。

操作项元素

• android:actionButtonStyle

• 给操作项按钮定义样式资源。

• android:actionBarItemBackground

•  给每个操作项的背景定义可描画资源（被添加在API 级别 14中）。

• android:itemBackground

•  给每个悬浮菜单项的背景定义可描画资源。

• android:actionBarDivider

• 给操作项之间的分隔线定义可描画资源（被添加在API 级别 14中）

• android:actionMenuTextColor

• 给显示在操作项中文本定义颜色。

• android:actionMenuTextAppearance

•  给显示在操作项中文本定义样式资源。

• android:actionBarWidgetTheme

• 给作为操作视窗被填充到操作栏中的可视构件定义主题资源（被添加在API级别14中）。

导航选项标签

android:actionBarTabStyle 给操作栏中的选项标签定义样式资源。android:actionBarTabBarStyle给显示在导航选项标签下方的细条定义样式资源。android:actionBarTabTextStyle给导航选项标签中的文本定义样式资源。 下拉列表

android:actionDropDownStyle 给下拉导航列表定义样式（如背景和文本样式）。 如，下例XML文件中给操作栏定义了一些定制的样式：

[html] view plaincopyprint?

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- the theme applied to the application or activity -->
    <style name="CustomActivityTheme" parent="@android:style/Theme.Holo">
        <item name="android:actionBarTabTextStyle">@style/CustomTabTextStyle</item>
        <item name="android:actionBarDivider">@drawable/ab_divider</item>
        <item name="android:actionBarItemBackground">@drawable/ab_item_background</item>
    </style>

    <!-- style for the action bar tab text -->
    <style name="CustomTabTextStyle" parent="@android:style/TextAppearance.Holo">
        <item name="android:textColor">#2456c2</item>
    </style>
</resources>

       注意：一定要在<style>标签中声明一个父主题，这样定制的主题可以继承所有没有明确声明的样式。在修改操作栏样式时，使用父主题是至关重要的，它会让你能够简单的覆写你想要改变的操作栏样式，而不影响你不想修改的样式（如文本的外观或操作项的边缘）。

      你能够在清单文件中把定制的主题应用到整个应用程序或一个单独的Activity对象，如：

<application android:theme="@style/CustomActivityTheme" ... />

高级样式

      如果需要比上述属性更高级的样式，可以在Activity的主题中包含android:actionBarStyle和android:actionBarSplitStyle属性。这两个属性的每一个都指定了另一种能够给操作栏定义各种属性的样式，包括带有android:background、android:backgroundSplit、android:backgroundStacked属性的不同背景。如果要覆盖这些操作栏样式，就要确保定义一个像Widget.Holo.ActionBar这样的父操作栏样式。

例如，如果要改变操作栏背景，你可以使用下列样式：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- the theme applied to the application or activity -->
    <style name="CustomActivityTheme" parent="@android:style/Theme.Holo">
        <item name="android:actionBarStyle">@style/MyActionBar</item>
        <!-- other activity and action bar styles here -->
    </style>

    <!-- style for the action bar backgrounds -->
    <style name="MyActionBar" parent="@android:style/Widget.Holo.ActionBar">
        <item name="android:background">@drawable/ab_background</item>
        <item name="android:backgroundStacked">@drawable/ab_background</item>
        <item name="android:backgroundSplit">@drawable/ab_split_background</item>
    </style>
</resources>