ActionBar Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Attributs
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 Holo du 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 requestFeature(FEATURE_ACTION_BAR) ou en la déclarant dans un thème personnalisé avec la propriété windowActionBar.
À 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’une des activités fournies. Thèmes NoActionBar, définissez l’attribut windowActionBar sur false ou ne demandez pas 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 un logo à la place de leur texte de titre standard.
À partir de votre activité, vous pouvez récupérer une instance d’ActionBar en appelant 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 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 API ActionMode sont distinctes et indépendantes de celles de ActionBar.
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.
Référence Android pour android.app.ActionBar.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| ActionBar() | |
| ActionBar(IntPtr, JniHandleOwnership) |
Initialise une représentation managée d’un objet Java Native Interface existant. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| 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 |
| IsShowing | |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| 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 JavaObject) |
| JniPeerMembers |
Fournit une infrastructure de liaison JNI pour Android.App.ActionBar. |
| NavigationItemCount |
Cette méthode a été déconseillée au niveau de l’API 21. |
| NavigationMode |
Cette méthode a été déconseillée au niveau de l’API 21. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| SelectedNavigationIndex |
Cette méthode a été déconseillée au niveau de l’API 21. |
| SelectedTab |
Cette méthode a été déconseillée au niveau de l’API 21. |
| Subtitle | |
| SubtitleFormatted |
Retourne le sous-titre ActionBar actuel en mode standard. |
| TabCount |
Cette méthode a été déconseillée au niveau de l’API 21. |
| ThemedContext |
Retourne un |
| ThresholdClass |
Fournit une infrastructure de liaison JNI pour Android.App.ActionBar. |
| ThresholdType |
Fournit une infrastructure de liaison JNI pour Android.App.ActionBar. |
| Title | |
| TitleFormatted |
Retourne le titre actionBar actuel en mode standard. |
Méthodes
| Nom | Description |
|---|---|
| AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
Ajoutez un écouteur qui répondra aux événements de modification de la visibilité du menu. |
| AddTab(ActionBar+Tab, Boolean) |
Obsolète.
Cette méthode a été déconseillée au niveau de l’API 21. |
| AddTab(ActionBar+Tab, Int32, Boolean) |
Obsolète.
Cette méthode a été déconseillée au niveau de l’API 21. |
| AddTab(ActionBar+Tab, Int32) |
Obsolète.
Cette méthode a été déconseillée au niveau de l’API 21. |
| AddTab(ActionBar+Tab) |
Obsolète.
Cette méthode a été déconseillée au niveau de l’API 21. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
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 JavaObject) |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| 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 JavaObject) |
| Equals(Object) |
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 JavaObject) |
| 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.
Cette méthode a été déconseillée au niveau de l’API 21. |
| Hide() |
Masquez la barre d’actions si elle s’affiche actuellement. |
| JavaFinalize() |
Obsolète.
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.
Cette méthode a été déconseillée au niveau de l’API 21. |
| 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.
Cette méthode a été déconseillée au niveau de l’API 21. |
| RemoveTabAt(Int32) |
Obsolète.
Supprimez un onglet de la barre d’action. |
| SelectTab(ActionBar+Tab) |
Obsolète.
Cette méthode a été déconseillée au niveau de l’API 21. |
| 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 |
| SetHomeAsUpIndicator(Int32) |
Définissez un autre dessinable à afficher en regard de l’icône/logo/titre lorsqu’il |
| 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.
Cette méthode a été déconseillée au niveau de l’API 21. |
| 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. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
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 JavaObject) |
| 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>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (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, 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) |
| 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) |
Événements
| Nom | Description |
|---|---|
| MenuVisibility | |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| 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 JavaObject) |
| 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 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
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 JavaObject) |
| 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 JavaObject) |
| 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 JavaObject) |
| 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 JavaObject) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| 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. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |