Barra de acción

Nuevo elemento aparecido con Android 3.0 (API 11) a través del tema holográfico, la barra de acción
reemplaza a la barra de título así como al menú de actividad tal y como aparecen en las versiones
anteriores.

Por defecto, de izquierda a derecha, la barra incluye el icono de la actividad o por defecto de la
aplicación, su título así como las opciones del menú de actividad que se muestran directamente en la
barra, mediante un submenú representado por un icono situado a la derecha del todo.

También es posible insertar directamente widgets en la barra de acción como, por ejemplo, una barra
de búsqueda, pestañas con fragmentos o una lista de navegación. También es posible modificar la
apariencia de la barra de acción y reemplazar el icono por una imagen.

1. Opciones de menú
Visibles directamente o accesibles mediante el submenú, las opciones de menú se gestionan tal y
como se explica en la sección Menús.

Por defecto, las opciones de menú aparecen en el submenú de la barra de acción, submenú accesible
mediante el icono situado a la derecha del todo. Es posible situar directamente una de estas
opciones de menú sobre la barra de acción, hay que utilizar para ello el
atributo android:showAsActionde la etiqueta itemcorrespondiente en la descripción XML del
menú. Las posibles opciones para el atributo android:showAsActionson las siguientes:

always: el elemento se mostrará siempre en la barra de acción.

ifRoom: el elemento se mostrará si el espacio disponible en la barra de acción lo permite.

never: el elemento no se mostrará jamás directamente en la barra de acción.

Existen dos atributos suplementarios que pueden ajustarse a los siguientes valores:

El valor withTextpermite indicar que también es preciso mostrar el título de la opción.

El valor collapseActionVue(disponible a partir de la API 14) permite indicar al sistema que

puede reducir el elemento a un icono, y mostrar la totalidad del elemento cuando el usuario
haga clic en el menú (en el caso de que el elemento sea un elemento compuesto, como una
zona de búsqueda, por ejemplo).

Ejemplo

<xml version="1.0" encoding="utf-8">

<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/menu_principal_opcion1"
android:icon="@drawable/menu_principal_opcion1"
android:title="@string/menu_principal_opcion1"
android:onClick="traitementOption1"
android:showAsAction="ifRoom|withText" />
</menu>

El método getActionBarde una actividad permite recuperar la instancia de su barra de acción de

tipo ActionBar.
Sintaxis

public ActionBar getActionBar ()

Ejemplo

ActionBar actionBar = getActionBar();

2. Icono de la aplicación
En una barra de acción, el icono de la actividad o por defecto de la aplicación forma también parte del
botón de acción. Cuando el usuario hace clic sobre él, se recomienda que la actividad en curso vuelva
a su estado inicial o que la aplicación vuelva a la pantalla de bienvenida (véase el capítulo Los
fundamentos - Actividad).

Para detectar el clic sobre el botón, hay que implementar el

método on OptionsItemSelectedvisto anteriormente (véase la sección Menús). Éste recibe un
objeto de tipo Itemcuyo identificador único es, en este caso, android.R.id.home. A continuación
es preciso implementarlo e iniciar la acción correspondiente.

El método se tDisplayHomeAsUpEnabled permite agregar una marca al icono para indicar al

usuario que al hacer clic sobre él es posible volver, no al inicio, sino a la actividad anterior. Hay que
pasarle como parámetro un valor booleano que active o no esta posibilidad.

Este método sólo permite modificar la visualización del icono, es tarea del desarrollador
procesar el clic del botón como se ha descrito anteriormente.

Sintaxis

public abstract void setDisplayHomeAsUpEnabled(boolean showHomeAsUp)

Ejemplo

actionBar.setDisplayHomeAsUpEnabled(true);