actionbar-displayOptions 属性分析

displayOptions 这个属性主要是控制这actionbar 上返回按钮、标题等的显示。它作为 actionBarStyle 的一个item，如下

 <style name="ActionBarStyle" parent="@android:style/Widget.Holo.Light.ActionBar.Solid.Inverse">
     <item name="android:displayOptions">showCustom|disableHome|showTitle|homeAsUp|</item>
 </style>

然后我们可以从 ActionBarView这个类中看到它的使用

setDisplayOptions(a.getInt(R.styleable.ActionBar_displayOptions, DISPLAY_DEFAULT));

我们通过查询源码

frameworks/base/core/res/res/values/attrs.xml

可以发现这条属性可以使用的成员如下

  <attr name="displayOptions">
            <flag name="none" value="" />
            <flag name="useLogo" value="0x1" />
            <flag name="showHome" value="0x2" />
            <flag name="homeAsUp" value="0x4" />
            <flag name="showTitle" value="0x8" />
            <flag name="showCustom" value="0x10" />
            <flag name="disableHome" value="0x20" />
   </attr>

它们对应的代码中的数值如下

            ActionBar.DISPLAY_USE_LOGO |
            ActionBar.DISPLAY_SHOW_HOME |
            ActionBar.DISPLAY_HOME_AS_UP |
            ActionBar.DISPLAY_SHOW_TITLE |
            ActionBar.DISPLAY_SHOW_CUSTOM |
//disableHome 代码中未看到
//这个是设置是否 action_bar_title 双行显示
            ActionBar.DISPLAY_TITLE_MULTIPLE_LINES;     

下面我们就来研究下，这几个属性到底是什么作用

直接看demo

actionbar style

<style name="ActionBarStyle" parent="@android:style/Widget.Holo.Light.ActionBar.Solid.Inverse">
     <item name="android:displayOptions">showCustom|disableHome|showTitle|homeAsUp|useLogo|showHome</item>
</style>

我们发现，actionbar上面就显示了三项。这三项分别是（从左到右）

homeAsUp-返回箭头

showHome-图标

showTitle-标题

其他没有显示的三项（接下来会研究）

useLogo-未知

showCustom-未知

disableHome-未知

我们去ActionBarView这个类中去寻找答案

1.showCustom

我们找到如下关键代码

 public void setCustomView(View view) {
        final boolean showCustom = (mDisplayOptions & ActionBar.DISPLAY_SHOW_CUSTOM) != 0;
        if (showCustom) {
            ActionBarTransition.beginDelayedTransition(this);
        }
        if (mCustomNavView != null && showCustom) {
            removeView(mCustomNavView);
        }
        mCustomNavView = view;
        if (mCustomNavView != null && showCustom) {
            addView(mCustomNavView);
        }
    }    

很明显，这个属性控制的是custoView的显示问题

2.disableHome

这个属性具体有什么作用，暂时还没有发现。在framework下搜索这个属性也没有找到具体使用的地方。

3.useLogo

还是从framework下寻找答案。我们从actionBarView中看到如下代码

 if ((flagsChanged & ActionBar.DISPLAY_USE_LOGO) != 0) {
         final boolean logoVis = mLogo != null && (options & ActionBar.DISPLAY_USE_LOGO) != 0;
         mHomeLayout.setIcon(logoVis ? mLogo : mIcon);
  }    

所以说，它的作用其实跟showHome是差不多的，它就是从manifest里面读取icon，然后在activity中显示出来

 <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:logo="@drawable/ic_person_add_24dp"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >

此外，我们还能看到如下代码

  final boolean showHome = (options & ActionBar.DISPLAY_SHOW_HOME) != 0;
            final boolean homeAsUp = (mDisplayOptions & ActionBar.DISPLAY_HOME_AS_UP) != 0;
            final boolean titleUp = !showHome && homeAsUp;
            mHomeLayout.setShowIcon(showHome);

 public void setShowIcon(boolean showIcon) {
            mIconView.setVisibility(showIcon ? VISIBLE : GONE);
        }

我们知道，showHome 是总开关。只有它跟useLogo 同时存在的时候，才能显示logo

看如下效果

我们既然知道了这几个属性的意义，那么我们如何改改他们的样式呢？这就需要我们去继续看它们的代码实现了。

还是在actionBarView中寻找答案

1.看到如下方法

public void setDisplayOptions(int options) {
    ......
}

我们还能从WindowDecorActionBar 中看到另一个相同的方法

public void setDisplayOptions(@DisplayOptions int options, @DisplayOptions int mask) {
    ......
}

这两个方法分析如下

直接看如下代码

  public void removeBackButton() {
        if (mActionBar == null) {
            return;
        }
        // Remove the back button but continue showing an icon.
        final int mask = ActionBar.DISPLAY_HOME_AS_UP | ActionBar.DISPLAY_SHOW_HOME;
        mActionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_HOME, mask);
        mActivity.getActionBar().setHomeButtonEnabled(false);
    }
/* Vanzo:zhangshuli on: Fri, 17 Apr 2015 18:15:31 +0800
 */
    public void setBackButtonEnable(boolean enable) {
        if (mActionBar == null) {
            return;
        }
        mActivity.getActionBar().setHomeButtonEnabled(enable);
    }
// End of Vanzo: zhangshuli

    public void setBackButton() {
        if (mActionBar == null) {
            return;
        }
        // Show home as up, and show an icon.
        final int mask = ActionBar.DISPLAY_HOME_AS_UP | ActionBar.DISPLAY_SHOW_HOME;
        mActionBar.setDisplayOptions(mask, mask);
        mActivity.getActionBar().setHomeButtonEnabled(true);
    }   

上面代码中

mActionBar.setDisplayOptions(mask, mask);

就是用来设置home按钮显示的，它的具体用法如下

（1）如果只有一个参数，那么它就是直接设定显示项，

如，

int options = DISPLAY_SHOW_HOME | DISPLAY_USE_LOGO；
setDisplayOptions(options);

那么，actionbar就会显示home跟log按钮，也就是，里面添加了谁，谁就显示

（2）如果有两个参数的话

int options = ActionBar.DISPLAY_SHOW_TITLE |ActionBar.DISPLAY_SHOW_HOME ;

int mask = ActionBar.DISPLAY_HOME_AS_UP | ActionBar.DISPLAY_SHOW_TITLE | ActionBar.DISPLAY_SHOW_HOME | ActionBar.DISPLAY_SHOW_CUSTOM;

getSupportActionBar().setDisplayOptions(options, mask);

如上代码，这时候actionbar会显示home 跟title，其他的不会显示

也就是只有当options在mask中被设置才能被显示，也就是设置为true。

2.单独设置上面某个属性显示与否

从WindowDecorActionBar 能看到如下方法

单独设置某项显示方法如下

getActionBar().setDisplayHomeAsUpEnabled(true);
getActionBar().setDisplayShowCustomEnabled(true);
getActionBar().setDisplayShowHomeEnabled(true);
getActionBar().setDisplayShowTitleEnabled(true);
getActionBar().setDisplayUseLogoEnabled(true);

3.设置各个按钮是否可点击状态

//它好像可以控制home等的点击状态
getActionBar().setHomeButtonEnabled(true);

这个方法实现如下

private void setHomeButtonEnabled(boolean enable, boolean recordState) {
        if (recordState) {
            mWasHomeEnabled = enable;
        }    

        if (mExpandedActionView != null) {
            // There's an action view currently showing and we want to keep the state
            // configured for the action view at the moment. If we needed to record the
            // new state for later we will have done so above.
            return;
        }    

        mUpGoerFive.setEnabled(enable);
        mUpGoerFive.setFocusable(enable);
        // Make sure the home button has an accurate content description for accessibility.
        updateHomeAccessibility(enable);
    }    

  mUpGoerFive = (ViewGroup) inflater.inflate(
                com.android.internal.R.layout.action_bar_up_container, this, false);
        mHomeLayout = (HomeView) inflater.inflate(homeResId, mUpGoerFive, false);

很清楚就知道了，它控制的其实是homeAsUp 跟home两个图标的显示问题

现在我们已经知道了它们的显示跟隐藏，那么我们通过什么方式来更改它们的图标呢。

仍然从代码中找答案

//设置home图标
public void setIcon(Drawable icon) {}
//设置logo图标
public void setLogo(Drawable logo) {}
//设置homeAsUp图标
public void setUpIndicator(Drawable d) {}
//设置title
public void setTitle(CharSequence title) {}
//设置subtitle
public void setSubtitle(CharSequence subtitle) {}

如何在xml中更改呢

<!-- 更改logo 跟icon-->
<application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:logo="@drawable/action_mode_search_normal_white_p"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >

更改homeAsUp

看up按钮在framework中的布局

<!-- 更改homeAsUp-->

 <ImageView android:id="@android:id/up"
               android:src="?android:attr/homeAsUpIndicator"
               android:layout_gravity="center_vertical|start"
               android:visibility="gone"
               android:layout_width="wrap_content"
               android:layout_height="wrap_content"
               android:layout_marginEnd="-8dip" />

所以我们可以在theme中修改它的图标

<item name="homeAsUpIndicator">@android:drawable/ic_ab_back_funui</item>