ActionBar Classe

Définition

Espace de noms:

Android.App

Assembly:

Mono.Android.dll

Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.

[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

Héritage

Object

Object

ActionBar

Attributs

RegisterAttribute

Remarques

Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.

À compter d’Android 3.0 (niveau d’API 11), la barre d’action apparaît en haut de la fenêtre d’une activité lorsque l’activité utilise le thème du android.R.style#Theme_Holo Holo système (ou l’un de ses thèmes descendants), qui est la valeur par défaut. Sinon, vous pouvez ajouter la barre d’actions en appelant android.view.Window#requestFeature requestFeature(FEATURE_ACTION_BAR) ou en la déclarant dans un thème personnalisé avec la android.R.styleable#Theme_windowActionBar windowActionBar propriété.

À compter d’Android L (niveau d’API 21), la barre d’action peut être représentée par n’importe quel widget de barre d’outils dans la disposition de l’application. L’application peut signaler à l’activité que la barre d’outils doit être traitée comme la barre d’action de l’activité. Les activités qui utilisent cette fonctionnalité doivent utiliser l’un des thèmes fournis .NoActionBar , définir l’attribut android.R.styleable#Theme_windowActionBar windowActionBarfalse sur ou ne pas demander la fonctionnalité de fenêtre.

En ajustant les fonctionnalités de fenêtre demandées par le thème et les dispositions utilisées pour la vue de contenu d’une activité, une application peut utiliser la barre d’action système standard sur les versions antérieures de la plateforme et les barres d’outils incorporées plus récentes sur les versions de plateforme plus récentes. L’objet ActionBar obtenu à partir de l’activité peut être utilisé pour contrôler la configuration de manière transparente.

Lorsque vous utilisez les thèmes Holo, la barre d’action affiche l’icône de l’application à gauche, suivie du titre de l’activité. Si votre activité comporte un menu d’options, vous pouvez rendre les éléments sélectionnés accessibles directement à partir de la barre d’action en tant qu'« éléments d’action ». Vous pouvez également modifier différentes caractéristiques de la barre d’action ou la supprimer complètement.

Lorsque vous utilisez les thèmes matériels (par défaut dans l’API 21 ou une version ultérieure), le bouton de navigation (anciennement « Accueil ») occupe l’espace précédemment occupé par l’icône de l’application. Les applications souhaitant exprimer une marque plus forte doivent utiliser leurs couleurs de marque fortement dans la barre d’action et d’autres applications chrome ou utiliser une #setLogo(int) logo place de leur texte de titre standard.

À partir de votre activité, vous pouvez récupérer une instance de l’appel ActionBarandroid.app.Activity#getActionBar getActionBar().

Dans certains cas, la barre d’action peut être retardée par une autre barre qui active les actions contextuelles à l’aide d’un android.view.ActionMode. Par exemple, lorsque l’utilisateur sélectionne un ou plusieurs éléments dans votre activité, vous pouvez activer un mode action qui offre des actions spécifiques aux éléments sélectionnés, avec une interface utilisateur qui remplace temporairement la barre d’actions. Bien que l’interface utilisateur puisse occuper le même espace, les android.view.ActionMode API sont distinctes et indépendantes de celles pour ActionBar.

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

Pour plus d’informations sur l’utilisation de la barre d’actions, notamment comment ajouter des éléments d’action, des modes de navigation et bien plus encore, lisez le guide du développeur de la barre d’actions.

</Div>

Documentation Java pour android.app.ActionBar.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Constructeurs

ActionBar()
ActionBar(IntPtr, JniHandleOwnership)	Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime.

Propriétés

Class	Retourne la classe runtime de ce Object. (Hérité de Object)
CustomView
DisplayOptions
Elevation	Obtenez l’élévation de l’axe Z de la barre d’action en pixels. -ou- Définissez l’élévation de l’axe Z de la barre d’action en pixels.
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
Height	Récupérez la hauteur actuelle de la barre d’actions.
HideOffset	Retourne le décalage vertical actuel de la barre d’action. -ou- Définissez le décalage de masquage actuel de la barre d’action.
HideOnContentScrollEnabled	Retourne si la barre d’action est configurée pour faire défiler la vue avec un View#setNestedScrollingEnabled(boolean) nested scrolling child. -ou- Activez le masquage de la barre d’action sur le défilement du contenu.
IsShowing
JniIdentityHashCode	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
JniPeerMembers	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.
NavigationItemCount	Obtenez le nombre d’éléments de navigation présents en mode de navigation actuel.
NavigationMode	Retourne le mode de navigation actuel.
PeerReference	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
SelectedNavigationIndex	Obtenez la position de l’élément de navigation sélectionné dans les modes de navigation à onglets ou de liste.
SelectedTab	Retourne l’onglet actuellement sélectionné s’il est en mode de navigation par onglets et qu’il y a au moins un onglet présent.
Subtitle	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.
SubtitleFormatted	Retourne le sous-titre ActionBar actuel en mode standard.
TabCount	Retourne le nombre d’onglets actuellement inscrits avec la barre d’action.
ThemedContext	Retourne un Context thème approprié pour créer des vues qui apparaîtront dans la barre d’actions.
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.
Title	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.
TitleFormatted	Retourne le titre actionBar actuel en mode standard.

Méthodes

AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Ajoutez un écouteur qui répondra aux événements de modification de la visibilité du menu.
AddTab(ActionBar+Tab)	Obsolète. Ajoutez un onglet à utiliser en mode de navigation par onglets.
AddTab(ActionBar+Tab, Boolean)	Obsolète. Ajoutez un onglet à utiliser en mode de navigation par onglets.
AddTab(ActionBar+Tab, Int32)	Obsolète. Ajoutez un onglet à utiliser en mode de navigation par onglets.
AddTab(ActionBar+Tab, Int32, Boolean)	Obsolète. Ajoutez un onglet à utiliser en mode de navigation par onglets.
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Dispose()	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
Dispose(Boolean)	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetHashCode()	Retourne une valeur de code de hachage pour l'objet. (Hérité de Object)
GetTabAt(Int32)	Obsolète. Retourne l’onglet à l’index spécifié.
Hide()	Masquez la barre d’actions si elle s’affiche actuellement.
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
NewTab()	Obsolète. Créez et retournez un nouveau ActionBar.Tab.
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
RemoveAllTabs()	Obsolète. Supprimez tous les onglets de la barre d’action et désélectionnez l’onglet actif.
RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener)	Supprimez un écouteur de visibilité de menu.
RemoveTab(ActionBar+Tab)	Obsolète. Supprimez un onglet de la barre d’action.
RemoveTabAt(Int32)	Obsolète. Supprimez un onglet de la barre d’action.
SelectTab(ActionBar+Tab)	Obsolète. Sélectionnez l’onglet spécifié.
SetBackgroundDrawable(Drawable)	Définissez l’arrière-plan de la barre d’actions.
SetCustomView(Int32)	Définissez la barre d’action en mode de navigation personnalisé, en fournissant une vue pour la navigation personnalisée.
SetCustomView(View, ActionBar+LayoutParams)	Définissez la barre d’action en mode de navigation personnalisé, en fournissant une vue pour la navigation personnalisée.
SetDisplayHomeAsUpEnabled(Boolean)	Définissez si la maison doit être affichée comme une affordance « up ».
SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions)	Définissez les options d’affichage sélectionnées.
SetDisplayShowCustomEnabled(Boolean)	Définissez si une vue personnalisée doit être affichée, si elle est définie.
SetDisplayShowHomeEnabled(Boolean)	Définissez s’il faut inclure l’affordance d’accueil de l’application dans la barre d’action.
SetDisplayShowTitleEnabled(Boolean)	Définissez si un titre/sous-titre d’activité doit être affiché.
SetDisplayUseLogoEnabled(Boolean)	Définissez s’il faut afficher le logo d’activité plutôt que l’icône d’activité.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetHomeActionContentDescription(ICharSequence)	Définissez une autre description de l’action Accueil/Up, lorsqu’elle est activée.
SetHomeActionContentDescription(Int32)	Définissez une autre description de l’action Accueil/Up, lorsqu’elle est activée.
SetHomeActionContentDescription(String)	Définissez une autre description de l’action Accueil/Up, lorsqu’elle est activée.
SetHomeAsUpIndicator(Drawable)	Définissez un autre dessinable à afficher en regard de l’icône/logo/titre lorsqu’il #DISPLAY_HOME_AS_UP est activé.
SetHomeAsUpIndicator(Int32)	Définissez un autre dessinable à afficher en regard de l’icône/logo/titre lorsqu’il #DISPLAY_HOME_AS_UP est activé.
SetHomeButtonEnabled(Boolean)	Activez ou désactivez le bouton « Accueil » dans le coin de la barre d’action.
SetIcon(Drawable)	Définissez l’icône à afficher dans la section « accueil » de la barre d’action.
SetIcon(Int32)	Définissez l’icône à afficher dans la section « accueil » de la barre d’action.
SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener)	Obsolète. Définissez l’adaptateur et le rappel de navigation pour le mode de navigation de liste.
SetLogo(Drawable)	Définissez le logo à afficher dans la section « accueil » de la barre d’action.
SetLogo(Int32)	Définissez le logo à afficher dans la section « accueil » de la barre d’action.
SetSelectedNavigationItem(Int32)	Obsolète. Définissez l’élément de navigation sélectionné dans les modes de navigation à onglets ou de liste.
SetSplitBackgroundDrawable(Drawable)	Définissez l’arrière-plan fractionné d’ActionBar.
SetStackedBackgroundDrawable(Drawable)	Définissez l’arrière-plan empilé d’ActionBar.
SetSubtitle(Int32)	Définissez le sous-titre de la barre d’actions.
SetTitle(Int32)	Définissez le titre de la barre d’action.
Show()	Affichez la barre d’actions si elle n’est pas affichée actuellement.
ToArray<T>()	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
ToString()	Retourne une représentation de chaîne de l'objet. (Hérité de Object)
UnregisterFromRuntime()	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Événements

MenuVisibility

Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.

Implémentations d’interfaces explicites

IJavaPeerable.Disposed()	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
IJavaPeerable.Finalized()	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
IJavaPeerable.JniManagedPeerState	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs. (Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.
GetJniTypeName(IJavaPeerable)	Barre d’outils principale de l’activité qui peut afficher le titre de l’activité, les affordances de navigation au niveau de l’application et d’autres éléments interactifs.