ActionBar Klasse

Definition

Namespace:

Android.App

Assembly:

Mono.Android.dll

Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.

[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

Vererbung

Object

Object

ActionBar

Attribute

RegisterAttribute

Hinweise

Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.

Ab Android 3.0 (API-Ebene 11) wird die Aktionsleiste oben im Fenster einer Aktivität angezeigt, wenn die Aktivität das Systemdesign (oder eines seiner Nachfolgerdesigns android.R.style#Theme_Holo Holo ) verwendet, das die Standardeinstellung ist. Sie können die Aktionsleiste andernfalls hinzufügen, indem Sie sie aufrufen android.view.Window#requestFeature requestFeature(FEATURE_ACTION_BAR) oder in einem benutzerdefinierten Design mit der android.R.styleable#Theme_windowActionBar windowActionBar -Eigenschaft deklarieren.

Ab Android L (API-Ebene 21) kann die Aktionsleiste durch jedes Symbolleistenwidget innerhalb des Anwendungslayouts dargestellt werden. Die Anwendung kann der Aktivität signalisieren, welche Symbolleiste als Aktionsleiste der Aktivität behandelt werden soll. Aktivitäten, die dieses Feature verwenden, sollten eines der angegebenen .NoActionBar Designs verwenden, das android.R.styleable#Theme_windowActionBar windowActionBar Attribut auf false festlegen oder das Fensterfeature anderweitig nicht anfordern.

Durch Anpassen der vom Design angeforderten Fensterfeatures und der Layouts, die für die Inhaltsansicht einer Aktivität verwendet werden, kann eine App die Standardmäßige Systemaktionsleiste auf älteren Plattformversionen und die neueren Inlinesymbolleisten auf neueren Plattformversionen verwenden. Das ActionBar aus der Aktivität abgerufene Objekt kann verwendet werden, um beide Konfigurationen transparent zu steuern.

Wenn Sie die Holo-Designs verwenden, wird auf der Aktionsleiste das Anwendungssymbol auf der linken Seite angezeigt, gefolgt vom Aktivitätstitel. Wenn Ihre Aktivität über ein Optionsmenü verfügt, können Sie auswahlelemente direkt über die Aktionsleiste als "Aktionselemente" zugänglich machen. Sie können auch verschiedene Merkmale der Aktionsleiste ändern oder vollständig entfernen.

Bei Verwendung der Materialdesigns (Standard in API 21 oder höher) übernimmt die Navigationsschaltfläche (früher "Start") den Platz, der zuvor vom Anwendungssymbol belegt wurde. Apps, die ein stärkeres Branding ausdrücken möchten, sollten ihre Markenfarben stark in der Aktionsleiste und anderen Chromanwendungen verwenden oder anstelle ihres Standardtiteltexts eine #setLogo(int) logo verwenden.

Aus Ihrer Aktivität können Sie eine instance von ActionBar abrufen, indem Sie aufrufenandroid.app.Activity#getActionBar getActionBar().

In einigen Fällen kann die Aktionsleiste mit einer android.view.ActionModeanderen Leiste überlagert werden, die kontextbezogene Aktionen ermöglicht. Wenn der Benutzer beispielsweise ein oder mehrere Elemente in Ihrer Aktivität auswählt, können Sie einen Aktionsmodus aktivieren, der spezifische Aktionen für die ausgewählten Elemente bietet, mit einer Benutzeroberfläche, die die Aktionsleiste vorübergehend ersetzt. Obwohl die Benutzeroberfläche denselben Platz einnehmen kann, unterscheiden sich die android.view.ActionMode APIs und sind unabhängig von denen für ActionBar.

<div class="special reference"><h3>Developer Guides</h3>

Informationen zur Verwendung der Aktionsleiste, einschließlich des Hinzufügens von Aktionselementen, Navigationsmodi und mehr, finden Sie im Entwicklerhandbuch für Aktionsleisten .

</Div>

Java-Dokumentation für android.app.ActionBar.

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

ActionBar()
ActionBar(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Runtime aufgerufen.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses Objectzurück. (Geerbt von Object)
CustomView
DisplayOptions
Elevation	Ruft die Z-Achse-Höhe der Aktionsleiste in Pixel ab. Oder: Legen Sie die Z-Achse-Höhe der Aktionsleiste in Pixel fest.
Handle	Das Handle für die zugrunde liegende Android-instance. (Geerbt von Object)
Height	Rufen Sie die aktuelle Höhe der Aktionsleiste ab.
HideOffset	Gibt den aktuellen vertikalen Offset der Aktionsleiste zurück. Oder: Legen Sie den aktuellen Ausblendeoffset der Aktionsleiste fest.
HideOnContentScrollEnabled	Gibt zurück, ob die Aktionsleiste für einen Bildlauf außerhalb der Sicht konfiguriert ist, zusammen mit einem View#setNestedScrollingEnabled(boolean) nested scrolling child. Oder: Aktivieren Sie das Ausblenden der Aktionsleiste beim Scrollen von Inhalten.
IsShowing
JniIdentityHashCode	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
JniPeerMembers	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.
NavigationItemCount	Ruft die Anzahl der Navigationselemente ab, die im aktuellen Navigationsmodus vorhanden sind.
NavigationMode	Gibt den aktuellen Navigationsmodus zurück.
PeerReference	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
SelectedNavigationIndex	Ruft die Position des ausgewählten Navigationselements im Navigationsmodus für Listen oder Registerkarten ab.
SelectedTab	Gibt die derzeit ausgewählte Registerkarte zurück, wenn sich im Navigationsmodus für Registerkarten befindet und mindestens eine Registerkarte vorhanden ist.
Subtitle	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.
SubtitleFormatted	Gibt den aktuellen ActionBar-Untertitel im Standardmodus zurück.
TabCount	Gibt die Anzahl der Registerkarten zurück, die derzeit mit der Aktionsleiste registriert sind.
ThemedContext	Gibt einen Context mit einem geeigneten Design zum Erstellen von Ansichten zurück, das in der Aktionsleiste angezeigt wird.
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
Title	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.
TitleFormatted	Gibt den aktuellen ActionBar-Titel im Standardmodus zurück.

Methoden

AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Fügen Sie einen Listener hinzu, der auf Änderungsereignisse der Menüsichtbarkeit reagiert.
AddTab(ActionBar+Tab)	Veraltet. Fügen Sie eine Registerkarte zur Verwendung im Navigationsmodus für Registerkarten hinzu.
AddTab(ActionBar+Tab, Boolean)	Veraltet. Fügen Sie eine Registerkarte zur Verwendung im Navigationsmodus für Registerkarten hinzu.
AddTab(ActionBar+Tab, Int32)	Veraltet. Fügen Sie eine Registerkarte zur Verwendung im Navigationsmodus für Registerkarten hinzu.
AddTab(ActionBar+Tab, Int32, Boolean)	Veraltet. Fügen Sie eine Registerkarte zur Verwendung im Navigationsmodus für Registerkarten hinzu.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Dispose()	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
Dispose(Boolean)	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem objekt ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetTabAt(Int32)	Veraltet. Gibt die Registerkarte am angegebenen Index zurück.
Hide()	Blenden Sie die Aktionsleiste aus, wenn sie derzeit angezeigt wird.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
NewTab()	Veraltet. Erstellen Sie eine neue ActionBar.Tab, und geben Sie es zurück.
Notify()	Aktiviert einen einzelnen Thread, der auf den Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf den Monitor dieses Objekts warten. (Geerbt von Object)
RemoveAllTabs()	Veraltet. Entfernen Sie alle Registerkarten aus der Aktionsleiste, und deaktivieren Sie die aktuelle Registerkarte.
RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Entfernen Sie einen Sichtbarkeitslistener für das Menü.
RemoveTab(ActionBar+Tab)	Veraltet. Entfernen Sie eine Registerkarte aus der Aktionsleiste.
RemoveTabAt(Int32)	Veraltet. Entfernen Sie eine Registerkarte aus der Aktionsleiste.
SelectTab(ActionBar+Tab)	Veraltet. Wählen Sie die angegebene Registerkarte aus.
SetBackgroundDrawable(Drawable)	Legen Sie den Hintergrund der Aktionsleiste fest.
SetCustomView(Int32)	Legen Sie die Aktionsleiste in den benutzerdefinierten Navigationsmodus fest, und stellen Sie eine Ansicht für die benutzerdefinierte Navigation bereit.
SetCustomView(View, ActionBar+LayoutParams)	Legen Sie die Aktionsleiste in den benutzerdefinierten Navigationsmodus fest, und stellen Sie eine Ansicht für die benutzerdefinierte Navigation bereit.
SetDisplayHomeAsUpEnabled(Boolean)	Legen Sie fest, ob home als "up"-Angebot angezeigt werden soll.
SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions)	Ausgewählte Anzeigeoptionen festlegen.
SetDisplayShowCustomEnabled(Boolean)	Legen Sie fest, ob eine benutzerdefinierte Ansicht angezeigt werden soll, sofern festgelegt.
SetDisplayShowHomeEnabled(Boolean)	Legen Sie fest, ob das Home-Angebot der Anwendung in die Aktionsleiste eingeschlossen werden soll.
SetDisplayShowTitleEnabled(Boolean)	Legen Sie fest, ob ein Aktivitätstitel bzw. -untertitel angezeigt werden soll.
SetDisplayUseLogoEnabled(Boolean)	Legen Sie fest, ob anstelle des Aktivitätssymbols das Aktivitätslogo angezeigt werden soll.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetHomeActionContentDescription(ICharSequence)	Legen Sie eine alternative Beschreibung für die Start-/Auf-Aktion fest, wenn sie aktiviert ist.
SetHomeActionContentDescription(Int32)	Legen Sie eine alternative Beschreibung für die Start-/Auf-Aktion fest, wenn sie aktiviert ist.
SetHomeActionContentDescription(String)	Legen Sie eine alternative Beschreibung für die Start-/Auf-Aktion fest, wenn sie aktiviert ist.
SetHomeAsUpIndicator(Drawable)	Legen Sie ein alternatives Zeichen fest, das neben dem Symbol/Logo/Titel angezeigt werden soll, wenn #DISPLAY_HOME_AS_UP aktiviert ist.
SetHomeAsUpIndicator(Int32)	Legen Sie ein alternatives Zeichen fest, das neben dem Symbol/Logo/Titel angezeigt werden soll, wenn #DISPLAY_HOME_AS_UP aktiviert ist.
SetHomeButtonEnabled(Boolean)	Aktivieren oder deaktivieren Sie die Schaltfläche "Start" in der Ecke der Aktionsleiste.
SetIcon(Drawable)	Legen Sie das Symbol fest, das im Abschnitt "Start" der Aktionsleiste angezeigt werden soll.
SetIcon(Int32)	Legen Sie das Symbol fest, das im Abschnitt "Start" der Aktionsleiste angezeigt werden soll.
SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener)	Veraltet. Legen Sie den Adapter und den Navigationsrückruf für den Listennavigationsmodus fest.
SetLogo(Drawable)	Legen Sie das Logo fest, das im Abschnitt "Startseite" der Aktionsleiste angezeigt werden soll.
SetLogo(Int32)	Legen Sie das Logo fest, das im Abschnitt "Startseite" der Aktionsleiste angezeigt werden soll.
SetSelectedNavigationItem(Int32)	Veraltet. Legen Sie das ausgewählte Navigationselement im Navigationsmodus für Listen oder Registerkarten fest.
SetSplitBackgroundDrawable(Drawable)	Legen Sie den geteilten Hintergrund der Aktionsleiste fest.
SetStackedBackgroundDrawable(Drawable)	Legen Sie den gestapelten Hintergrund der Aktionsleiste fest.
SetSubtitle(Int32)	Legen Sie den Untertitel der Aktionsleiste fest.
SetTitle(Int32)	Legen Sie den Titel der Aktionsleiste fest.
Show()	Zeigt die Aktionsleiste an, wenn sie derzeit nicht angezeigt wird.
ToArray<T>()	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch <>Benachrichtigung</em> oder <em>interrupted</em>. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</em>, oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert ist, in der Regel durch>< Benachrichtigung</em> oder <em>interrupted</em>, oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Ereignisse

MenuVisibility

Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
IJavaPeerable.Finalized()	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Typkonvertierung mit Überprüfung der Android-Laufzeit aus.
JavaCast<TResult>(IJavaObject)	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.
GetJniTypeName(IJavaPeerable)	Eine primäre Symbolleiste innerhalb der Aktivität, auf der möglicherweise der Aktivitätstitel, Navigationsangebote auf Anwendungsebene und andere interaktive Elemente angezeigt werden.