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
- Наследование
- Атрибуты
Комментарии
Основная панель инструментов в действии, которая может отображать заголовок действия, возможности навигации на уровне приложения и другие интерактивные элементы.
Начиная с 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
вместо стандартного текста заголовка.
Из действия можно получить экземпляр ActionBar
, вызвав .android.app.Activity#getActionBar getActionBar()
В некоторых случаях панель действий может быть наложена другой панелью, которая включает контекстные действия с помощью android.view.ActionMode
. Например, когда пользователь выбирает один или несколько элементов в действии, можно включить режим действий, который предлагает действия, относящиеся к выбранным элементам, с пользовательским интерфейсом, который временно заменяет панель действий. Хотя пользовательский интерфейс может занимать одно и то же пространство, android.view.ActionMode
API-интерфейсы отличаются и не зависят от интерфейсов для ActionBar
.
<div class="special reference"><h3>Developer Guides</h3>
Сведения об использовании панели действий, в том числе о добавлении элементов действий, режимов навигации и т. д., см. в руководстве разработчика панели действий .
</Div>
Документация по Java для android.app.ActionBar
.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.
Конструкторы
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 для Android и не предназначен для использования непосредственно из кода. |
ThresholdType |
Этот API поддерживает инфраструктуру Mono для 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) |
Задайте альтернативное описание для действия Home/Up, если включено. |
SetHomeActionContentDescription(Int32) |
Задайте альтернативное описание для действия Home/Up, если включено. |
SetHomeActionContentDescription(String) |
Задайте альтернативное описание для действия Home/Up, если включено. |
SetHomeAsUpIndicator(Drawable) |
Задайте альтернативный отрисовываемый объект, который будет отображаться рядом со значком, логотипом или заголовком, если |
SetHomeAsUpIndicator(Int32) |
Задайте альтернативный отрисовываемый объект, который будет отображаться рядом со значком, логотипом или заголовком, если |
SetHomeButtonEnabled(Boolean) |
Включите или отключите кнопку "Домой" в углу панели действий. |
SetIcon(Drawable) |
Задайте значок для отображения в разделе home панели действий. |
SetIcon(Int32) |
Задайте значок для отображения в разделе home панели действий. |
SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener) |
Устаревшие..
Задайте адаптер и обратный вызов навигации для режима навигации по списку. |
SetLogo(Drawable) |
Задайте логотип для отображения в разделе home панели действий. |
SetLogo(Int32) |
Задайте логотип для отображения в разделе home панели действий. |
SetSelectedNavigationItem(Int32) |
Устаревшие..
Задайте выбранный элемент навигации в режимах навигации со списками или вкладками. |
SetSplitBackgroundDrawable(Drawable) |
Задайте разделенный фон ActionBar. |
SetStackedBackgroundDrawable(Drawable) |
Задайте фон с накоплением ActionBar. |
SetSubtitle(Int32) |
Задайте подзаголовок панели действий. |
SetTitle(Int32) |
Задайте заголовок панели действий. |
Show() |
Показать панель действий, если она не отображается в данный момент. |
ToArray<T>() |
Основная панель инструментов в действии, которая может отображать заголовок действия, возможности навигации на уровне приложения и другие интерактивные элементы. (Унаследовано от Object) |
ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
UnregisterFromRuntime() |
Основная панель инструментов в действии, которая может отображать заголовок действия, возможности навигации на уровне приложения и другие интерактивные элементы. (Унаследовано от Object) |
Wait() |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления/><em> или <прерывания></em>. (Унаследовано от Object) |
Wait(Int64) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object) |
Wait(Int64, Int32) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> 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) |
Основная панель инструментов в действии, которая может отображать заголовок действия, возможности навигации на уровне приложения и другие интерактивные элементы. |