ActionBar Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann.
[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
- Attribute
Hinweise
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. Beginnend mit Android 3.0 (API-Ebene 11) wird die Aktionsleiste oben im Fenster einer Aktivität angezeigt, wenn die Aktivität das Holo-Design des Systems (oder eines seiner untergeordneten Designs) verwendet. Dies ist die Standardeinstellung. Andernfalls können Sie die Aktionsleiste durch Aufrufen von requestFeature(FEATURE_ACTION_BAR) oder durch Deklarieren in einem benutzerdefinierten Design mit der windowActionBar-Eigenschaft hinzufügen.
Ab Android L (API-Ebene 21) kann die Aktionsleiste von jedem Symbolleisten-Widget im Anwendungslayout dargestellt werden. Die Anwendung kann signalisieren, welche Symbolleiste als Aktionsleiste der Aktivität behandelt werden soll. Aktivitäten, die dieses Feature verwenden, sollten eine der bereitgestellten . NoActionBar designs, set the windowActionBar attribute to false or otherwise not request the window feature.
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 für ältere Plattformversionen und die neueren Inlinesymbolleisten auf neueren Plattformversionen verwenden. Das aus der Aktivität abgerufene ActionBar-Objekt kann verwendet werden, um beide Konfigurationen transparent zu steuern.
Wenn Sie die Holo-Designs verwenden, zeigt die Aktionsleiste das Anwendungssymbol auf der linken Seite an, 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 Anwendungschromen verwenden oder ein Logo anstelle ihres Standardtiteltexts verwenden.
Aus Ihrer Aktivität können Sie eine Instanz von ActionBar abrufen, indem Sie getActionBar() aufrufen.
In einigen Fällen kann die Aktionsleiste durch eine andere Leiste überlagert werden, die kontextbezogene Aktionen mithilfe eines ActionMode ermöglicht. Wenn der Benutzer beispielsweise ein oder mehrere Elemente in Ihrer Aktivität auswählt, können Sie einen Aktionsmodus aktivieren, der für die ausgewählten Elemente spezifische Aktionen bietet, mit einer Benutzeroberfläche, die die Aktionsleiste vorübergehend ersetzt. Obwohl die Benutzeroberfläche denselben Platz belegen kann, unterscheiden sich die ActionMode-APIs von denen für ActionBar.
Informationen zur Verwendung der Aktionsleiste, einschließlich des Hinzufügens von Aktionselementen, Navigationsmodi und mehr, finden Sie im Entwicklerhandbuch für Aktionsleisten.
Android-Referenz für android.app.ActionBar.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| ActionBar() |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
| ActionBar(IntPtr, JniHandleOwnership) |
Initialisiert eine verwaltete Darstellung eines vorhandenen Java Native Interface -Objekts. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| CustomView |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
| DisplayOptions |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
| Elevation |
Ruft die Z-Achse-Höhe der Aktionsleiste in Pixeln ab. |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| Height |
Rufen Sie die aktuelle Höhe der Aktionsleiste ab. |
| HideOffset |
Gibt den aktuellen vertikalen Offset der Aktionsleiste zurück. |
| HideOnContentScrollEnabled |
Gibt zurück, ob die Aktionsleiste so konfiguriert ist, dass ein Bildlauf außerhalb des Sichtfelds zusammen mit einem geschachtelten untergeordneten Bildlauf ausgeführt wird. |
| IsShowing |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniPeerMembers |
Stellt JNI-Bindungsinfrastruktur für Android.App.ActionBar bereit. |
| NavigationItemCount |
Diese Methode war in API-Ebene 21 veraltet. |
| NavigationMode |
Diese Methode war in API-Ebene 21 veraltet. |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| SelectedNavigationIndex |
Diese Methode war in API-Ebene 21 veraltet. |
| SelectedTab |
Diese Methode war in API-Ebene 21 veraltet. |
| Subtitle |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
| SubtitleFormatted |
Gibt den aktuellen ActionBar-Untertitel im Standardmodus zurück. |
| TabCount |
Diese Methode war in API-Ebene 21 veraltet. |
| ThemedContext |
Gibt einen Kontext mit einem geeigneten Design zum Erstellen von Ansichten zurück, die in der Aktionsleiste angezeigt werden. |
| ThresholdClass |
Stellt JNI-Bindungsinfrastruktur für Android.App.ActionBar bereit. |
| ThresholdType |
Stellt JNI-Bindungsinfrastruktur für Android.App.ActionBar bereit. |
| Title |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
| TitleFormatted |
Gibt den aktuellen ActionBar-Titel im Standardmodus zurück. |
Methoden
| Name | Beschreibung |
|---|---|
| AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
Fügen Sie einen Listener hinzu, der auf Änderungsereignisse der Menüsichtbarkeit reagiert. |
| AddTab(ActionBar+Tab, Boolean) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| AddTab(ActionBar+Tab, Int32, Boolean) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| AddTab(ActionBar+Tab, Int32) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| AddTab(ActionBar+Tab) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten 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.
Diese Methode war in API-Ebene 21 veraltet. |
| Hide() |
Blenden Sie die Aktionsleiste aus, wenn sie zurzeit angezeigt wird. |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| NewTab() |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| RemoveAllTabs() |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
Entfernen Sie einen Listener für die Menüsichtbarkeit. |
| RemoveTab(ActionBar+Tab) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| RemoveTabAt(Int32) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| SelectTab(ActionBar+Tab) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| 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 zur Verfügung. |
| SetCustomView(View, ActionBar+LayoutParams) |
Legen Sie die Aktionsleiste in den benutzerdefinierten Navigationsmodus fest, und stellen Sie eine Ansicht für die benutzerdefinierte Navigation zur Verfügung. |
| SetDisplayHomeAsUpEnabled(Boolean) |
Legen Sie fest, ob home als "up"-Angebot angezeigt werden soll. |
| SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions) |
Festlegen ausgewählter Anzeigeoptionen. |
| SetDisplayShowCustomEnabled(Boolean) |
Legen Sie fest, ob eine benutzerdefinierte Ansicht angezeigt werden soll, falls festgelegt. |
| SetDisplayShowHomeEnabled(Boolean) |
Legen Sie fest, ob das Startangebot der Anwendung in die Aktionsleiste eingeschlossen werden soll. |
| SetDisplayShowTitleEnabled(Boolean) |
Legen Sie fest, ob ein Aktivitätstitel/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-/Up-Aktion fest, wenn diese aktiviert ist. |
| SetHomeActionContentDescription(Int32) |
Legen Sie eine alternative Beschreibung für die Start-/Up-Aktion fest, wenn diese aktiviert ist. |
| SetHomeActionContentDescription(String) |
Legen Sie eine alternative Beschreibung für die Start-/Up-Aktion fest, wenn diese aktiviert ist. |
| SetHomeAsUpIndicator(Drawable) |
Legen Sie eine alternative Zeichnung fest, die neben dem Symbol/Logo/Titel angezeigt werden kann, wenn DISPLAY_HOME_AS_UP aktiviert ist. |
| SetHomeAsUpIndicator(Int32) |
Legen Sie eine alternative Zeichnung fest, die neben dem Symbol/Logo/Titel angezeigt werden kann, 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.
Diese Methode war in API-Ebene 21 veraltet. |
| SetLogo(Drawable) |
Legen Sie das Logo fest, das im Abschnitt "Start" der Aktionsleiste angezeigt werden soll. |
| SetLogo(Int32) |
Legen Sie das Logo fest, das im Abschnitt "Start" der Aktionsleiste angezeigt werden soll. |
| SetSelectedNavigationItem(Int32) |
Veraltet.
Diese Methode war in API-Ebene 21 veraltet. |
| 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() |
Zeigen Sie die Aktionsleiste an, wenn sie derzeit nicht angezeigt wird. |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Ereignisse
| Name | Beschreibung |
|---|---|
| MenuVisibility |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
Benachrichtigt die Interoplaufzeit, dass dieser verwaltete Peer verworfen wurde. (Geerbt von Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Gibt diesen Java Peer frei, es sei denn, er wird von einem anderen verwalteten Verweis beibehalten. (Geerbt von Object) |
| IJavaPeerable.Finalized() |
Benachrichtigt die Interoplaufzeit, dass dieser verwaltete Peer abgeschlossen wurde. (Geerbt von Object) |
| IJavaPeerable.JniManagedPeerState |
Ruft den Zustand ab, der die Beziehung zwischen diesem verwalteten Peer und seinem JNI-Verweis beschreibt. (Geerbt von Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Legt den Interop-Identitätshashcode für diesen Java Peer fest. (Geerbt von Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Legt den verwalteten und JNI-Peerstatus für diesen Java Peer fest. (Geerbt von Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Legt den JNI-Objektverweis fest, der von diesem verwalteten Peer verwendet wird. (Geerbt von Object) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Eine primäre Symbolleiste innerhalb der Aktivität, die den Aktivitätstitel, navigationsangebot auf Anwendungsebene und andere interaktive Elemente anzeigen kann. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |