Añadir botones de acción
Un item de acción es simplemente un item de menú del menú de opciones que debería aparecer en la barra de acción. Un item de acción puede incluir un icono y/o texto. Si un item de menú no aparece como un item de acción , el sistema lo coloca en un overflow menu, que el usuario puede abrir con el icono del menú en la parte derecha de la barra de acción.
Figura 2. Pantallazo de una barra de acción con dos items de acción y el overflow menu.
Cuando la actividad se inicia, el sistema rellena la barra de acción y el overflow menu llamando al método
onCreateOptionsMenu(). Tal y como se detalla en la sección Crear menús, es en este método callback donde se define el menú de opciones para la actividad.
Se puede hacer que item del menú aparezca como un item de acción—si existe lugar para él—desde el recurso de menú mediante la declaración del
android:showAsAction="ifRoom" para el elemento <item>. De esta manera, el item del menú aparece como acceso directo en la barra de acción sólo si existe lugar para ello. Si no hay suficiente lugar, el item se coloca en el overflow menu (mostrado por el icon del menú en la parte derecha de la barra de acción).
También se puede declarar un item del menú para que aparezca como un item de acción en el código de la aplicación, llamando al método
setShowAsAction() en el MenuItem y pasándole SHOW_AS_ACTION_IF_ROOM.
Si el item del menú tiene un título y un icono, el item de acción, por defecto sólo muestra el icono. Si se quiere incluir el texto con el item de acción, hay que añadir el flag "with text": en el XML, añadir
withText al atributo android:showAsAction o, utilizar en el código de la aplicación el flag SHOW_AS_ACTION_WITH_TEXT cuando se llama al método setShowAsAction(). La figura 2 muestra una barra de acción que tiene dos items de acción con su texto y el icono para el overflow menu.
A continuación tenemos un ejemplo de cómo se puede declarar un item de menú como un item de acción en un archivo recurso de menú:
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/menu_add"
android:icon="@drawable/ic_menu_save"
android:title="@string/menu_save"
android:showAsAction="ifRoom|withText" />
</menu>
En este caso, los dos flags
ifRoom y withText están seteados, por lo que cuando este item aparece como un item de acción, incluye el texto del título junto con el icono.
Un item de menú colocado en la barra de acción dispara los mismos métodos callback que otros items del menú de opciones. Cuando el usuario selecciona un item de acción, la actividad recibe una llamada al método
onOptionsItemSelected(), pasándole el item ID.
Nota: Si se añade un item del menú desde un fragmento, se llama al método
onOptionsItemSelected()correspondiente para ese fragmento. Si la actividad lo maneja primero, el sistema llama al método onOptionsItemSelected() de la actividad antes de llamar al fragmento.
También se puede declarar un item para que aparezca siempre como un item de acción, pero se debe evitar, ya que puede crear una IU recargada debido a la presencia de demasiados items de acción y pueden llegar a chocar con otros elementos de la barra de acción.
Para más información sobre los menús, ver el documento sobre Crear menús.
Sintaxis:
Lo mas importante viene marcado en rojo
<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="http://schemas.android.com/apk/res/android"> <item android:id="@[+][package:]id/resource_name" android:title="string" android:titleCondensed="string" android:icon="@[package:]drawable/drawable_resource_name" android:onClick="method name" android:showAsAction=["ifRoom" | "never" | "withText" | "always"] android:actionLayout="@[package:]layout/layout_resource_name" android:actionViewClass="class name" android:alphabeticShortcut="string" android:numericShortcut="string" android:checkable=["true" | "false"] android:visible=["true" | "false"] android:enabled=["true" | "false"] android:menuCategory=["container" | "system" | "secondary" | "alternative"] android:orderInCategory="integer" /> <group android:id="@[+][package:]id/resource name" android:checkableBehavior=["none" | "all" | "single"] android:visible=["true" | "false"] android:enabled=["true" | "false"] android:menuCategory=["container" | "system" | "secondary" | "alternative"] android:orderInCategory="integer" > <item /> </group> <item > <menu> <item /> </menu> </item> </menu>
res/menu/example_menu.xml:<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/item1"
android:title="@string/item1"
android:icon="@drawable/group_item1_icon"
android:showAsAction="ifRoom|withText"/>
<group android:id="@+id/group">
<item android:id="@+id/group_item1"
android:onClick="onGroupItemClick"
android:title="@string/group_item1"
android:icon="@drawable/group_item1_icon" />
<item android:id="@+id/group_item2"
android:onClick="onGroupItemClick"
android:title="@string/group_item2"
android:icon="@drawable/group_item2_icon" />
</group>
<item android:id="@+id/submenu"
android:title="@string/submenu_title"
android:showAsAction="ifRoom|withText" >
<menu>
<item android:id="@+id/submenu_item1"
android:title="@string/submenu_item1" />
</menu>
</item>
</menu>
The following application code inflates the menu from the
onCreateOptionsMenu(Menu) callback and also declares the on-click callback for two of the items:public boolean onCreateOptionsMenu(Menu menu) {
MenuInflater inflater = getMenuInflater();
inflater.inflate(R.menu.example_menu, menu);
return true;
}
public void onGroupItemClick(MenuItem item) {
// One of the group items (using the onClick attribute) was clicked
// The item parameter passed here indicates which item it is
// All other menu item clicks are handled by onOptionsItemSelected()
}
Note: The
android:showAsAction attribute is available only on Android 3.0 (API Level 11) and greater.
mil gracias por conpartir esta informacion es de muchisisisiisma utilidad esta muy bien especificada =3 gracias :D
ResponderEliminar