ActionBar

DISPLAY_HOME_AS_UP

int DISPLAY_HOME_AS_UP

显示“家”元素，使其显示为“上”的可供选择。 例如，向左侧显示一个箭头，指示将采取的行动。 如果选择操作栏中的“主页”按钮，将其设置为在用户界面中以单个级别返回，而不是返回顶层或首页，请设置此标志。

设置此选项将隐式启用与home / up按钮的交互。 见setHomeButtonEnabled(boolean) 。

常量值：4（0x00000004）

DISPLAY_SHOW_CUSTOM

int DISPLAY_SHOW_CUSTOM

显示自定义视图，如果已经设置。

常量值：16（0x00000010）

DISPLAY_SHOW_HOME

int DISPLAY_SHOW_HOME

在此操作栏中显示“家”元素，为其他导航元素留出更多空间。 这包括徽标和图标。

常量值：2（0x00000002）

DISPLAY_SHOW_TITLE

int DISPLAY_SHOW_TITLE

显示活动标题和副标题（如果有）。

常量值：8（0x00000008）

DISPLAY_USE_LOGO

int DISPLAY_USE_LOGO

如果可用，请使用徽标而不是图标。 此标志将导致适当的导航模式使用更广泛的标志代替标准图标。

常数值：1（0x00000001）

NAVIGATION_MODE_LIST

int NAVIGATION_MODE_LIST

此常数在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

列表导航模式。 该模式不是静态标题文本，而是在活动中提供用于导航的列表菜单。 例如，这可能会以下拉列表的形式呈现给用户。

常数值：1（0x00000001）

NAVIGATION_MODE_STANDARD

int NAVIGATION_MODE_STANDARD

此常数在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

标准导航模式。 包含徽标或图标和标题文字以及可选的字幕。 单击这些元素中的任何一个将使用项目ID android.R.id.home的MenuItem将onOptionsItemSelected派发到主机Activity。

常量值：0（0x00000000）

NAVIGATION_MODE_TABS

int NAVIGATION_MODE_TABS

此常数在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑使用其他common navigation patterns来代替。

Tab导航模式。 此模式不是静态标题文本，而是在活动中提供一系列导航栏。

常量值：2（0x00000002）

ActionBar

ActionBar ()

addOnMenuVisibilityListener

void addOnMenuVisibilityListener (ActionBar.OnMenuVisibilityListener listener)

添加一个将响应菜单可见性更改事件的侦听器。

addTab

void addTab (ActionBar.Tab tab, 
                int position)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

添加选项卡以在选项卡式导航模式下使用。 该标签将被插入到position 。 如果这是要添加的第一个选项卡，它将成为选定的选项卡。

addTab

void addTab (ActionBar.Tab tab)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

添加选项卡以在选项卡式导航模式下使用。 该选项卡将添加到列表的末尾。 如果这是要添加的第一个选项卡，它将成为选定的选项卡。

addTab

void addTab (ActionBar.Tab tab, 
                int position, 
                boolean setSelected)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

添加选项卡以在选项卡式导航模式下使用。 该标签将在position处position 。

addTab

void addTab (ActionBar.Tab tab, 
                boolean setSelected)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

添加选项卡以在选项卡式导航模式下使用。 该选项卡将添加到列表的末尾。

getCustomView

View getCustomView ()

getDisplayOptions

int getDisplayOptions ()

getElevation

float getElevation ()

以像素为单位获取操作栏的Z轴高程。

操作栏的高程是它从其父表面放置的距离。 较高的值更接近用户。

getHeight

int getHeight ()

检索ActionBar的当前高度。

getHideOffset

int getHideOffset ()

返回操作栏的当前垂直偏移量。

操作栏的当前隐藏偏移量是操作栏当前以像素为单位滚动离屏的距离。 有效范围为0（完全可见）到操作栏当前测量的height （完全不可见）。

getNavigationItemCount

int getNavigationItemCount ()

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑使用其他common navigation patterns 。

获取当前导航模式下存在的导航项目数量。

getNavigationMode

int getNavigationMode ()

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

返回当前的导航模式。 结果将是以下之一：

• NAVIGATION_MODE_STANDARD
• NAVIGATION_MODE_LIST
• NAVIGATION_MODE_TABS

getSelectedNavigationIndex

int getSelectedNavigationIndex ()

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

以列表或标签导航模式获取所选导航项目的位置。

getSelectedTab

ActionBar.Tab getSelectedTab ()

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

如果处于选项卡式导航模式且至少存在一个选项卡，则返回当前选定的选项卡。

getSubtitle

CharSequence getSubtitle ()

以标准模式返回当前的ActionBar字幕。 如果getNavigationMode()不返回NAVIGATION_MODE_STANDARD则返回null。

getTabAt

ActionBar.Tab getTabAt (int index)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

返回指定索引处的选项卡。

getTabCount

int getTabCount ()

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑使用其他common navigation patterns来代替。

返回当前在操作栏中注册的选项卡数量。

getThemedContext

Context getThemedContext ()

用适当的主题返回一个Context ，用于创建将出现在操作栏中的视图。 如果您正在充气或实例化将出现在操作栏中的自定义视图，则应该使用此方法返回的上下文。 （这包括用于列表导航模式的适配器。）这将确保视图与操作栏对比。

getTitle

CharSequence getTitle ()

在标准模式下返回当前的ActionBar标题。 如果getNavigationMode()不返回NAVIGATION_MODE_STANDARD则返回null。

hide

void hide ()

如果它正在显示，请隐藏ActionBar。 如果承载ActionBar的窗口没有功能FEATURE_ACTION_BAR_OVERLAY ，它将调整应用程序内容的大小以适应新的可用空间。

不是直接调用此函数，也可以使用叠加功能使ActionBar通过View.SYSTEM_UI_FLAG_FULLSCREEN隐藏。 通过此系统UI标志隐藏ActionBar可以让您更加无缝地将其与其他屏幕装饰一起隐藏。

isHideOnContentScrollEnabled

boolean isHideOnContentScrollEnabled ()

返回操作栏是否配置为与 nested scrolling child一起滚动到视线 nested scrolling child 。

isShowing

boolean isShowing ()

newTab

ActionBar.Tab newTab ()

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

创建并返回一个新的ActionBar.Tab 。 该标签在添加之前不会包含在操作栏中。

通常，制表符将用于在Fragment对象之间Fragment 。 以下是这些选项卡的典型实现：

import android.app.ActionBar;
import android.app.ActionBar.Tab;
import android.app.Activity;
import android.app.Fragment;
import android.app.FragmentTransaction;
import android.os.Bundle;
import android.widget.Toast;

/**
 * This demonstrates the use of action bar tabs and how they interact
 * with other action bar features.
 */
public class FragmentTabs extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        final ActionBar bar = getActionBar();
        bar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);
        bar.setDisplayOptions(0, ActionBar.DISPLAY_SHOW_TITLE);

        bar.addTab(bar.newTab()
                .setText("Simple")
                .setTabListener(new TabListener<FragmentStack.CountingFragment>(
                        this, "simple", FragmentStack.CountingFragment.class)));
        bar.addTab(bar.newTab()
                .setText("Contacts")
                .setTabListener(new TabListener<LoaderCursor.CursorLoaderListFragment>(
                        this, "contacts", LoaderCursor.CursorLoaderListFragment.class)));
        bar.addTab(bar.newTab()
                .setText("Apps")
                .setTabListener(new TabListener<LoaderCustom.AppListFragment>(
                        this, "apps", LoaderCustom.AppListFragment.class)));
        bar.addTab(bar.newTab()
                .setText("Throttle")
                .setTabListener(new TabListener<LoaderThrottle.ThrottledLoaderListFragment>(
                        this, "throttle", LoaderThrottle.ThrottledLoaderListFragment.class)));

        if (savedInstanceState != null) {
            bar.setSelectedNavigationItem(savedInstanceState.getInt("tab", 0));
        }
    }

    @Override
    protected void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);
        outState.putInt("tab", getActionBar().getSelectedNavigationIndex());
    }

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

        public TabListener(Activity activity, String tag, Class<T> clz) {
            this(activity, tag, clz, null);
        }

        public TabListener(Activity activity, String tag, Class<T> clz, Bundle args) {
            mActivity = activity;
            mTag = tag;
            mClass = clz;
            mArgs = args;

            // Check to see if we already have a fragment for this tab, probably
            // from a previously saved state.  If so, deactivate it, because our
            // initial state is that a tab isn't shown.
            mFragment = mActivity.getFragmentManager().findFragmentByTag(mTag);
            if (mFragment != null && !mFragment.isDetached()) {
                FragmentTransaction ft = mActivity.getFragmentManager().beginTransaction();
                ft.detach(mFragment);
                ft.commit();
            }
        }

        public void onTabSelected(Tab tab, FragmentTransaction ft) {
            if (mFragment == null) {
                mFragment = Fragment.instantiate(mActivity, mClass.getName(), mArgs);
                ft.add(android.R.id.content, mFragment, mTag);
            } else {
                ft.attach(mFragment);
            }
        }

        public void onTabUnselected(Tab tab, FragmentTransaction ft) {
            if (mFragment != null) {
                ft.detach(mFragment);
            }
        }

        public void onTabReselected(Tab tab, FragmentTransaction ft) {
            Toast.makeText(mActivity, "Reselected!", Toast.LENGTH_SHORT).show();
        }
    }
}

removeAllTabs

void removeAllTabs ()

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑使用其他common navigation patterns来代替。

从操作栏中删除所有选项卡并取消选择当前选项卡。

removeOnMenuVisibilityListener

void removeOnMenuVisibilityListener (ActionBar.OnMenuVisibilityListener listener)

删除菜单可见性侦听器。 该监听器将不再接收菜单可见性更改事件。

removeTab

void removeTab (ActionBar.Tab tab)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

从操作栏中删除一个选项卡。 如果选择了删除的选项卡，则将取消选择该选项卡，如果存在，则会选择另一个选项卡。

removeTabAt

void removeTabAt (int position)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

从操作栏中删除一个选项卡。 如果选择了删除的选项卡，则将取消选择该选项卡，如果存在，则会选择另一个选项卡。

selectTab

void selectTab (ActionBar.Tab tab)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

选择指定的选项卡。 如果它不是此操作栏的子项，它将被添加。

注意：如果您想按索引选择，请使用 setSelectedNavigationItem(int) 。

setBackgroundDrawable

void setBackgroundDrawable (Drawable d)

设置ActionBar的背景。 这将用于主要操作栏。

setCustomView

void setCustomView (View view, 
                ActionBar.LayoutParams layoutParams)

将操作栏设置为自定义导航模式，为自定义导航提供视图。

自定义导航视图显示在应用程序图标和任何操作按钮之间，可以使用任何可用的空间。 自定义导航视图的常见用例可能包括浏览器的自动建议地址栏或其他导航机制，这些机制不能很好地转换为提供的导航模式。

必须设置显示选项 DISPLAY_SHOW_CUSTOM以显示自定义视图。

setCustomView

void setCustomView (View view)

将操作栏设置为自定义导航模式，为自定义导航提供视图。 自定义导航视图显示在应用程序图标和任何操作按钮之间，可以使用任何可用的空间。 自定义导航视图的常见用例可能包括浏览器的自动建议地址栏或其他导航机制，这些机制不能很好地转换为提供的导航模式。

setCustomView

void setCustomView (int resId)

将操作栏设置为自定义导航模式，为自定义导航提供视图。

自定义导航视图显示在应用程序图标和任何操作按钮之间，可以使用任何可用的空间。 自定义导航视图的常见用例可能包括浏览器的自动建议地址栏或其他导航机制，这些机制不能很好地转换为提供的导航模式。

必须设置显示选项 DISPLAY_SHOW_CUSTOM以显示自定义视图。

setDisplayHomeAsUpEnabled

void setDisplayHomeAsUpEnabled (boolean showHomeAsUp)

设置家庭是否应该显示为“up”的可供选择性。 如果选择“home”返回到您的UI中的单个级别而不是回到顶级或首页，请将其设置为true。

要一次设置多个显示选项，请参阅setDisplayOptions方法。

setDisplayOptions

void setDisplayOptions (int options, 
                int mask)

设置选定的显示选项。 只有由掩码指定的选项才会更改。 要一次更改所有显示选项位，请参见setDisplayOptions(int) 。

例如：setDisplayOptions（0，DISPLAY_SHOW_HOME）将禁用DISPLAY_SHOW_HOME选项。 setDisplayOptions（DISPLAY_SHOW_HOME，DISPLAY_SHOW_HOME | DISPLAY_USE_LOGO）将启用DISPLAY_SHOW_HOME并禁用DISPLAY_USE_LOGO 。

setDisplayOptions

void setDisplayOptions (int options)

设置显示选项。 这会一次更改所有显示选项位。 要更改显示选项的有限子集，请参阅setDisplayOptions(int, int) 。

setDisplayShowCustomEnabled

void setDisplayShowCustomEnabled (boolean showCustom)

设置是否应显示自定义视图（如果已设置）。

要一次设置多个显示选项，请参阅setDisplayOptions方法。

setDisplayShowHomeEnabled

void setDisplayShowHomeEnabled (boolean showHome)

设置是否将应用程序主页示功表包含在操作栏中。 首页作为活动图标或徽标呈现。

要一次设置多个显示选项，请参阅setDisplayOptions方法。

setDisplayShowTitleEnabled

void setDisplayShowTitleEnabled (boolean showTitle)

设置是否显示活动标题/副标题。

要一次设置多个显示选项，请参阅setDisplayOptions方法。

setDisplayUseLogoEnabled

void setDisplayUseLogoEnabled (boolean useLogo)

设置是否显示活动徽标而不是活动图标。 徽标通常是一个更广泛，更详细的图像。

要一次设置多个显示选项，请参阅setDisplayOptions方法。

setElevation

void setElevation (float elevation)

以像素为单位设置操作栏的Z轴高程。

操作栏的高程是它从其父表面放置的距离。 较高的值更接近用户。

setHideOffset

void setHideOffset (int offset)

设置操作栏的当前隐藏偏移量。

操作栏的当前隐藏偏移量是操作栏当前以像素为单位滚动离屏的距离。 有效范围为0（完全可见）到操作栏当前测量的height （完全不可见）。

setHideOnContentScrollEnabled

void setHideOnContentScrollEnabled (boolean hideOnContentScroll)

在内容滚动中启用隐藏操作栏。

如果启用，操作栏将与视图的内容一起滚动到视线nested scrolling child 。 操作栏必须位于overlay mode以启用隐藏内容滚动。

当部分滚动屏幕时，操作栏被视为hidden 。 致电show将导致它返回到全视图。

setHomeActionContentDescription

void setHomeActionContentDescription (CharSequence description)

设置Home / Up操作的备用描述。

此描述通常用于启用“主页”操作时的辅助功能/屏幕阅读器。 （请参阅setDisplayHomeAsUpEnabled(boolean) ）根据DISPLAY_HOME_AS_UP显示选项，此示例为“导航首页”或“导航”。 如果您已使用setHomeAsUpIndicator(int)更改了家中指示灯，以指示更具体的功能（如滑动抽屉），则还应将其设置为准确描述该操作。

将其设置为 null将使用系统默认描述。

setHomeActionContentDescription

void setHomeActionContentDescription (int resId)

设置Home / Up操作的备用描述。

此描述通常用于启用“主页”操作时的辅助功能/屏幕阅读器。 （请参阅setDisplayHomeAsUpEnabled(boolean) ）根据DISPLAY_HOME_AS_UP显示选项，此示例为“导航首页”或“导航”。 如果您使用setHomeAsUpIndicator(int)更改了家中指示灯，以指示更具体的功能，例如滑动抽屉，则还应该将其设置为准确描述该操作。

将其设置为 0将使用系统默认描述。

setHomeAsUpIndicator

void setHomeAsUpIndicator (int resId)

当启用DISPLAY_HOME_AS_UP时，设置一个替代的可绘制图标以显示在图标/徽标/标题DISPLAY_HOME_AS_UP 。 如果您使用此模式显示上方导航的替代选择，例如滑动抽屉，则此功能非常有用。

如果您将 0传递给此方法，则将使用主题的默认drawable。

如果您在Up上执行备用或中间行为，则还应该致电 setHomeActionContentDescription()以提供可访问性支持操作的正确说明。

setHomeAsUpIndicator

void setHomeAsUpIndicator (Drawable indicator)

当启用DISPLAY_HOME_AS_UP时，设置一个替代的可绘制图标以在图标/徽标/标题旁显示。 如果您使用此模式显示上方导航的替代选择，例如滑动抽屉，则此功能非常有用。

如果您将 null传递给此方法，则将使用主题的默认drawable。

如果您在Up中执行替代或中间行为，则还应该致电 setHomeActionContentDescription()以提供可访问性支持操作的正确说明。

setHomeButtonEnabled

void setHomeButtonEnabled (boolean enabled)

启用或禁用操作栏角落中的“主页”按钮。 （请注意，这是应用程序主页上的动作栏，而不是系统范围的主页按钮。）

对于定位<API 14的软件包，此默认值为true。对于定位API 14或更高版本的软件包，应用程序应该调用此方法以启用与家庭/实用程序功能的交互。

设置 DISPLAY_HOME_AS_UP显示选项将自动启用主页按钮。

setIcon

void setIcon (Drawable icon)

将图标设置为显示在操作栏的“主页”部分。 操作栏默认使用由其风格或活动图标指定的图标。 显示选项DISPLAY_USE_LOGO是否控制主页显示图标或徽标。

setIcon

void setIcon (int resId)

将图标设置为显示在操作栏的“主页”部分。 操作栏默认使用由其风格或活动图标指定的图标。 显示选项DISPLAY_USE_LOGO控制主页显示图标或徽标。

setListNavigationCallbacks

void setListNavigationCallbacks (SpinnerAdapter adapter, 
                ActionBar.OnNavigationListener callback)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

为列表导航模式设置适配器和导航回调。 提供的适配器将为扩展列表以及当前选定的项目提供视图。 （这些可能会以不同方式显示。）提供的OnNavigationListener将在用户更改当前列表选择时提醒应用程序。

setLogo

void setLogo (int resId)

将徽标设置为显示在操作栏的“主页”部分。 操作栏默认使用由其风格或活动徽标指定的徽标。 显示选项DISPLAY_USE_LOGO控制主页显示图标或徽标。

setLogo

void setLogo (Drawable logo)

将徽标设置为显示在操作栏的“主页”部分。 操作栏默认使用由其风格或活动徽标指定的徽标。 显示选项DISPLAY_USE_LOGO是否控制主页显示图标或徽标。

setNavigationMode

void setNavigationMode (int mode)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

设置当前的导航模式。

setSelectedNavigationItem

void setSelectedNavigationItem (int position)

此方法在API级别21中已弃用。
内置工具栏操作栏不支持操作栏导航模式。 考虑改用其他common navigation patterns 。

以列表或标签导航模式设置选定的导航项目。

setSplitBackgroundDrawable

void setSplitBackgroundDrawable (Drawable d)

设置ActionBar的分割背景。 这将显示在包含某些设备和配置上的菜单提供的操作按钮的拆分操作栏中。

您可以启用拆分操作栏 uiOptions

setStackedBackgroundDrawable

void setStackedBackgroundDrawable (Drawable d)

设置ActionBar的堆叠背景。 这将出现在某些设备和配置的第二行/堆叠栏中。

setSubtitle

void setSubtitle (CharSequence subtitle)

设置操作栏的副标题。 这仅在设置了DISPLAY_SHOW_TITLE时才会显示。 设置为null以完全禁用字幕。

setSubtitle

void setSubtitle (int resId)

设置操作栏的副标题。 这仅在设置了DISPLAY_SHOW_TITLE时才会显示。

setTitle

void setTitle (CharSequence title)

设置操作栏的标题。 这仅在设置了DISPLAY_SHOW_TITLE时才会显示。

setTitle

void setTitle (int resId)

设置操作栏的标题。 这仅在设置了DISPLAY_SHOW_TITLE时才会显示。

show

void show ()

显示ActionBar，如果它当前不显示。 如果托管ActionBar的窗口没有该功能FEATURE_ACTION_BAR_OVERLAY ，它将调整应用程序内容的大小以适应新的可用空间。

如果您通过 View.SYSTEM_UI_FLAG_FULLSCREEN隐藏ActionBar，则不应直接调用此函数。