ActionBar Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos.
[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- Herencia
- Atributos
Comentarios
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. A partir de Android 3.0 (nivel de API 11), la barra de acciones aparece en la parte superior de la ventana de una actividad cuando la actividad usa el tema holo del sistema (o uno de sus temas descendientes), que es el valor predeterminado. De lo contrario, puede agregar la barra de acciones llamando a requestFeature(FEATURE_ACTION_BAR) o declarandola en un tema personalizado con la propiedad windowActionBar.
A partir de Android L (nivel de API 21), la barra de acciones puede representarse mediante cualquier widget de barra de herramientas dentro del diseño de la aplicación. La aplicación puede indicar a la actividad que la barra de herramientas debe tratarse como la barra de acciones de la actividad. Las actividades que usan esta característica deben usar una de las proporcionadas. Temas NoActionBar, establezca el atributo windowActionBar en false o, de lo contrario, no solicite la característica de ventana.
Al ajustar las características de ventana solicitadas por el tema y los diseños usados para la vista de contenido de una actividad, una aplicación puede usar la barra de acciones del sistema estándar en versiones anteriores de la plataforma y las barras de herramientas insertadas más recientes en las versiones más recientes de la plataforma. El objeto ActionBar obtenido de la actividad se puede usar para controlar cualquier configuración de forma transparente.
Al usar los temas de Holo, la barra de acciones muestra el icono de la aplicación a la izquierda, seguido del título de la actividad. Si la actividad tiene un menú de opciones, puede hacer que los elementos seleccionados sean accesibles directamente desde la barra de acciones como "elementos de acción". También puede modificar varias características de la barra de acciones o quitarla por completo.
Cuando se usan los temas material (valor predeterminado en api 21 o posterior), el botón de navegación (anteriormente "Inicio") ocupa el espacio ocupado previamente por el icono de la aplicación. Las aplicaciones que deseen expresar una personalización de marca más fuerte deben usar sus colores de marca en gran medida en la barra de acciones y en otro cromo de la aplicación o usar un logotipo en lugar de su texto de título estándar.
Desde la actividad, puede recuperar una instancia de ActionBar llamando a getActionBar().
En algunos casos, la barra de acciones se puede superponer mediante otra barra que habilita acciones contextuales mediante actionMode. Por ejemplo, cuando el usuario selecciona uno o varios elementos de la actividad, puede habilitar un modo de acción que ofrezca acciones específicas de los elementos seleccionados, con una interfaz de usuario que reemplace temporalmente la barra de acciones. Aunque la interfaz de usuario puede ocupar el mismo espacio, las API actionMode son distintas e independientes de las de ActionBar.
Para obtener información sobre cómo usar la barra de acciones, incluido cómo agregar elementos de acción, modos de navegación y mucho más, lea la guía para desarrolladores de la barra de acciones.
Referencia de Android para android.app.ActionBar.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| ActionBar() |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
| ActionBar(IntPtr, JniHandleOwnership) |
Inicializa una representación administrada de un objeto Java Native Interface existente. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| CustomView |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
| DisplayOptions |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
| Elevation |
Obtiene la elevación del eje Z de la barra de acciones en píxeles. |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| Height |
Recupere el alto actual de ActionBar. |
| HideOffset |
Devuelve el desplazamiento vertical actual de la barra de acciones. |
| HideOnContentScrollEnabled |
Devuelve si la barra de acciones está configurada para desplazarse fuera de la vista junto con un elemento secundario de desplazamiento anidado. |
| IsShowing |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| JniPeerMembers |
Proporciona la infraestructura de enlace JNI para Android.App.ActionBar. |
| NavigationItemCount |
Este método está en desuso en el nivel de API 21. |
| NavigationMode |
Este método está en desuso en el nivel de API 21. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| SelectedNavigationIndex |
Este método está en desuso en el nivel de API 21. |
| SelectedTab |
Este método está en desuso en el nivel de API 21. |
| Subtitle |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
| SubtitleFormatted |
Devuelve el subtítulo actionBar actual en modo estándar. |
| TabCount |
Este método está en desuso en el nivel de API 21. |
| ThemedContext |
Devuelve un contexto con un tema adecuado para crear vistas que aparecerán en la barra de acciones. |
| ThresholdClass |
Proporciona la infraestructura de enlace JNI para Android.App.ActionBar. |
| ThresholdType |
Proporciona la infraestructura de enlace JNI para Android.App.ActionBar. |
| Title |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
| TitleFormatted |
Devuelve el título actionBar actual en modo estándar. |
Métodos
| Nombre | Description |
|---|---|
| AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
Agregue un agente de escucha que responderá a los eventos de cambio de visibilidad del menú. |
| AddTab(ActionBar+Tab, Boolean) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| AddTab(ActionBar+Tab, Int32, Boolean) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| AddTab(ActionBar+Tab, Int32) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| AddTab(ActionBar+Tab) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| Equals(Object) |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| GetTabAt(Int32) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| Hide() |
Oculte actionBar si se muestra actualmente. |
| JavaFinalize() |
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| NewTab() |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| RemoveAllTabs() |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
Quitar un agente de escucha de visibilidad del menú. |
| RemoveTab(ActionBar+Tab) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| RemoveTabAt(Int32) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| SelectTab(ActionBar+Tab) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| SetBackgroundDrawable(Drawable) |
Establezca el fondo de ActionBar. |
| SetCustomView(Int32) |
Establezca la barra de acciones en modo de navegación personalizado y proporcione una vista para la navegación personalizada. |
| SetCustomView(View, ActionBar+LayoutParams) |
Establezca la barra de acciones en modo de navegación personalizado y proporcione una vista para la navegación personalizada. |
| SetDisplayHomeAsUpEnabled(Boolean) |
Establezca si el hogar debe mostrarse como una prestación "ascendente". |
| SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions) |
Establezca las opciones de visualización seleccionadas. |
| SetDisplayShowCustomEnabled(Boolean) |
Establezca si se debe mostrar una vista personalizada, si se establece. |
| SetDisplayShowHomeEnabled(Boolean) |
Establezca si se va a incluir la prestación doméstica de la aplicación en la barra de acciones. |
| SetDisplayShowTitleEnabled(Boolean) |
Establezca si se debe mostrar un título o un subtítulo de actividad. |
| SetDisplayUseLogoEnabled(Boolean) |
Establezca si se va a mostrar el logotipo de la actividad en lugar del icono de actividad. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetHomeActionContentDescription(ICharSequence) |
Establezca una descripción alternativa para la acción Inicio/Inicio cuando esté habilitada. |
| SetHomeActionContentDescription(Int32) |
Establezca una descripción alternativa para la acción Inicio/Inicio cuando esté habilitada. |
| SetHomeActionContentDescription(String) |
Establezca una descripción alternativa para la acción Inicio/Inicio cuando esté habilitada. |
| SetHomeAsUpIndicator(Drawable) |
Establezca un dibujo alternativo para mostrar junto al icono, el logotipo o el título cuando DISPLAY_HOME_AS_UP esté habilitado. |
| SetHomeAsUpIndicator(Int32) |
Establezca un dibujo alternativo para mostrar junto al icono, el logotipo o el título cuando DISPLAY_HOME_AS_UP esté habilitado. |
| SetHomeButtonEnabled(Boolean) |
Habilite o deshabilite el botón "inicio" en la esquina de la barra de acciones. |
| SetIcon(Drawable) |
Establezca el icono que se mostrará en la sección "inicio" de la barra de acciones. |
| SetIcon(Int32) |
Establezca el icono que se mostrará en la sección "inicio" de la barra de acciones. |
| SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| SetLogo(Drawable) |
Establezca el logotipo para que se muestre en la sección "inicio" de la barra de acciones. |
| SetLogo(Int32) |
Establezca el logotipo para que se muestre en la sección "inicio" de la barra de acciones. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| SetSelectedNavigationItem(Int32) |
Obsoletos.
Este método está en desuso en el nivel de API 21. |
| SetSplitBackgroundDrawable(Drawable) |
Establezca el fondo dividido de ActionBar. |
| SetStackedBackgroundDrawable(Drawable) |
Establezca el fondo apilado de ActionBar. |
| SetSubtitle(Int32) |
Establezca el subtítulo de la barra de acciones. |
| SetTitle(Int32) |
Establezca el título de la barra de acciones. |
| Show() |
Muestra actionBar si no se muestra actualmente. |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Eventos
| Nombre | Description |
|---|---|
| MenuVisibility |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| IJavaPeerable.Finalized() |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. (Heredado de JavaObject) |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Barra de herramientas principal dentro de la actividad que puede mostrar el título de la actividad, las prestaciones de navegación de nivel de aplicación y otros elementos interactivos. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |