ActionBar 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。
[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
- 继承
- 属性
注解
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。
从 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.ActionBar
Java 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
ActionBar() | |
ActionBar(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
Class |
返回此 |
CustomView | |
DisplayOptions | |
Elevation |
获取操作栏的 Z 轴高程(以像素为单位)。 - 或 - 设置操作栏的 Z 轴高程(以像素为单位)。 |
Handle |
基础 Android 实例的句柄。 (继承自 Object) |
Height |
检索 ActionBar 的当前高度。 |
HideOffset |
返回操作栏的当前垂直偏移量。 - 或 - 设置操作栏的当前隐藏偏移量。 |
HideOnContentScrollEnabled |
返回是否将操作栏配置为随一起 |
IsShowing | |
JniIdentityHashCode |
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。 (继承自 Object) |
JniPeerMembers |
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。 |
NavigationItemCount |
获取当前导航模式下存在的导航项数。 |
NavigationMode |
返回当前导航模式。 |
PeerReference |
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。 (继承自 Object) |
SelectedNavigationIndex |
获取所选导航项在列表或选项卡式导航模式下的位置。 |
SelectedTab |
如果处于选项卡式导航模式并且至少有一个选项卡存在,则返回当前选定的选项卡。 |
Subtitle |
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。 |
SubtitleFormatted |
返回标准模式下的当前 ActionBar 副标题。 |
TabCount |
返回当前向操作栏注册的选项卡数。 |
ThemedContext |
返回一个 |
ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
Title |
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。 |
TitleFormatted |
返回标准模式下的当前 ActionBar 标题。 |
方法
事件
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) |
活动中的主工具栏,可以显示活动标题、应用程序级导航提示和其他交互式项。 |