ActionBar 类

定义

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

[Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)]
public abstract class ActionBar : Java.Lang.Object
[<Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)>]
type ActionBar = class
    inherit Object
继承
ActionBar
属性

注解

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

从 Android 3.0(API 级别 11 开始),当活动使用系统 android.R.style#Theme_Holo Holo 的主题(或其后代主题之一)时,操作栏将显示在活动窗口顶部,这是默认值。 否则,可以通过调用 android.view.Window#requestFeature requestFeature(FEATURE_ACTION_BAR) 或在具有属性的自定义主题 android.R.styleable#Theme_windowActionBar windowActionBar 中声明操作栏来添加操作栏。

从 Android L(API 级别 21 开始),操作栏可以由应用程序布局中的任何工具栏小组件表示。 应用程序可能会向活动发出信号,即应将工具栏视为活动的操作栏。 使用此功能的活动应使用提供 .NoActionBar 的主题之一,将 android.R.styleable#Theme_windowActionBar windowActionBar 属性 false 设置为或不请求窗口功能。

通过调整主题请求的窗口功能和用于活动内容视图的布局,应用可以在较旧的平台版本中使用标准系统操作栏,并在较新的平台版本中使用较新的内联工具栏。 ActionBar从活动获取的对象可用于以透明方式控制任一配置。

使用 Holo 主题时,操作栏会显示左侧的应用程序图标,后跟活动标题。 如果活动具有选项菜单,则可以将直接从操作栏中访问的选择项作为“操作项”。 还可以修改操作栏的各种特征,或者完全删除它。

使用材料主题(API 21 或更高版本中的默认值)时,导航按钮(以前为“主页”)会接管应用程序图标以前占用的空间。 希望表达更强品牌的应用应在操作栏和其他应用程序版式中大量使用其品牌颜色,或者使用 #setLogo(int) logo 代替其标准标题文本。

从活动中,可以通过调用android.app.Activity#getActionBar getActionBar()来检索实例ActionBar

在某些情况下,操作栏可能由另一个允许上下文操作的条覆盖,使用 android.view.ActionMode。 例如,当用户在活动中选择一个或多个项目时,可以启用一种操作模式,该模式提供特定于所选项的操作,并具有临时替换操作栏的 UI。 尽管 UI 可能占用相同的空间,但 android.view.ActionMode API 是不同的,独立于这些 API。ActionBar

<div class=“special reference”><h3>Developer Guides</h3>

有关如何使用操作栏的信息,包括如何添加操作项、导航模式等,请阅读 操作栏 开发人员指南。

</div>

适用于 . 的 android.app.ActionBarJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

构造函数

ActionBar()
ActionBar(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

属性

Class

返回此 Object的运行时类。

(继承自 Object)
CustomView
DisplayOptions
Elevation

获取操作栏的 Z 轴高程(以像素为单位)。 - 或 - 设置操作栏的 Z 轴高程(以像素为单位)。

Handle

基础 Android 实例的句柄。

(继承自 Object)
Height

检索 ActionBar 的当前高度。

HideOffset

返回操作栏的当前垂直偏移量。 - 或 - 设置操作栏的当前隐藏偏移量。

HideOnContentScrollEnabled

返回是否将操作栏配置为随一起 View#setNestedScrollingEnabled(boolean) nested scrolling child滚动出视线。 - 或 - 启用在内容滚动上隐藏操作栏。

IsShowing
JniIdentityHashCode

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
JniPeerMembers

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

NavigationItemCount

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

NavigationMode

返回当前导航模式。

PeerReference

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
SelectedNavigationIndex

获取所选导航项在列表或选项卡式导航模式下的位置。

SelectedTab

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

Subtitle

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

SubtitleFormatted

返回标准模式下的当前 ActionBar 副标题。

TabCount

返回当前向操作栏注册的选项卡数。

ThemedContext

返回一个 Context 具有相应主题的主题,用于创建将在操作栏中显示的视图。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

Title

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

TitleFormatted

返回标准模式下的当前 ActionBar 标题。

方法

AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)

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

AddTab(ActionBar+Tab)
已过时.

添加选项卡以在选项卡式导航模式下使用。

AddTab(ActionBar+Tab, Boolean)
已过时.

添加选项卡以在选项卡式导航模式下使用。

AddTab(ActionBar+Tab, Int32)
已过时.

添加选项卡以在选项卡式导航模式下使用。

AddTab(ActionBar+Tab, Int32, Boolean)
已过时.

添加选项卡以在选项卡式导航模式下使用。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Dispose()

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
Dispose(Boolean)

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetTabAt(Int32)
已过时.

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

Hide()

如果操作栏当前显示,则隐藏该操作栏。

JavaFinalize()

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
NewTab()
已过时.

创建并返回一个新 ActionBar.Tab

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
RemoveAllTabs()
已过时.

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

RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)

删除菜单可见性侦听器。

RemoveTab(ActionBar+Tab)
已过时.

从操作栏中删除选项卡。

RemoveTabAt(Int32)
已过时.

从操作栏中删除选项卡。

SelectTab(ActionBar+Tab)
已过时.

选择指定的选项卡。

SetBackgroundDrawable(Drawable)

设置 ActionBar 的背景。

SetCustomView(Int32)

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

SetCustomView(View, ActionBar+LayoutParams)

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

SetDisplayHomeAsUpEnabled(Boolean)

设置家庭是否应显示为“向上”的负担。

SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions)

设置所选的显示选项。

SetDisplayShowCustomEnabled(Boolean)

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

SetDisplayShowHomeEnabled(Boolean)

设置是否在操作栏中包括应用程序家庭负担。

SetDisplayShowTitleEnabled(Boolean)

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

SetDisplayUseLogoEnabled(Boolean)

设置是否显示活动徽标而不是活动图标。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetHomeActionContentDescription(ICharSequence)

启用后,为“开始/启动”操作设置备用说明。

SetHomeActionContentDescription(Int32)

启用后,为“开始/启动”操作设置备用说明。

SetHomeActionContentDescription(String)

启用后,为“开始/启动”操作设置备用说明。

SetHomeAsUpIndicator(Drawable)

设置一个备用可绘制器,以便在启用图标/徽标/标题旁边 #DISPLAY_HOME_AS_UP 显示。

SetHomeAsUpIndicator(Int32)

设置一个备用可绘制器,以便在启用图标/徽标/标题旁边 #DISPLAY_HOME_AS_UP 显示。

SetHomeButtonEnabled(Boolean)

启用或禁用操作栏角的“主页”按钮。

SetIcon(Drawable)

设置图标以在操作栏的“主页”部分中显示。

SetIcon(Int32)

设置图标以在操作栏的“主页”部分中显示。

SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener)
已过时.

设置列表导航模式的适配器和导航回调。

SetLogo(Drawable)

设置要在操作栏的“主页”部分中显示的徽标。

SetLogo(Int32)

设置要在操作栏的“主页”部分中显示的徽标。

SetSelectedNavigationItem(Int32)
已过时.

在列表或选项卡式导航模式下设置所选导航项。

SetSplitBackgroundDrawable(Drawable)

设置 ActionBar 的拆分背景。

SetStackedBackgroundDrawable(Drawable)

设置 ActionBar 的堆积背景。

SetSubtitle(Int32)

设置操作栏的副标题。

SetTitle(Int32)

设置操作栏的标题。

Show()

显示 ActionBar(如果当前未显示)。

ToArray<T>()

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
Wait()

使当前线程等待,直到唤醒它,通常是通过 em 通知/em> 或 <em>interrupted</em>。<><

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted</em>>,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted</em>>,或直到经过一定数量的实时。

(继承自 Object)

事件

MenuVisibility

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

显式接口实现

IJavaPeerable.Disposed()

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
IJavaPeerable.Finalized()

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
IJavaPeerable.JniManagedPeerState

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

(继承自 Object)

扩展方法

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

GetJniTypeName(IJavaPeerable)

活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。

适用于