Ver el código de «Menús»

==Introducción==
*Nesta unidade imos ver como xestionar menús, submenús e menú contextuais.

*A seguinte imaxe amosa os menús na '''Action Bar''' da aplicación
[[Image:Actionbar.png|300px]]
*'''1''': Icona da App e nome
*'''2''': Dúas iconas de menús da aplicación
*'''3''': Menú '''OverFlow''' que equivale ao botón Menú da Botonera.
*Os menús poden poñerse na '''Action Bar''' dende a versión 3.0 de Android.



*Para versións anteriores á 3.0 os menús víanse como na parte inferior da seguinte imaxe:
[[Image:Options_menu.png|300px]]



*A seguinte imaxe amosa 3 botóns de menú na Barra de Acción e o menú Overflow
[[Image:Actionbar-item-withtext.png|300px]]



*Nesta imaxe vese como un dos menús da action bar ten '''submenús''':
[[Image:Actionbar-shareaction2x.png||300px]]




*Finalmente as seguintes imaxes amosan '''Menús Contextuais'''
**'''Flotantes''' (esquerda)
**ou na '''barra de accións''' (dereita)
[[Image:Menu-context.png|300px]]



*'''Referencias''':
**http://developer.android.com/guide/topics/ui/menus.html
**http://developer.android.com/guide/topics/resources/menu-resource.html
**http://developer.android.com/guide/topics/ui/actionbar.html
**http://developer.android.com/design/patterns/actionbar.html

==Menus e submenús básicos==
*Imos realizar unha aplicación con 3 menús (un deles con submenús e outro cunha icona na Barra de Acción).
*Antes imos ver distintas casuísticas:

===Recursos Implicados===
*Os menús defínense nun recurso xml en '''res/menu/nome_ficheiro.xml'''
[[Image:Android_2014_U5_01_Menus_08.jpg|200px]]

*Dito recurso terá coma elementos:
**'''<menu>''': elemento raíz. Contén <item> e <group>
**'''<item>''': representa un elemento de menú. 
***Tería que ter un elemento '''<menu>''' dentro de <item> para crear un submenú.


*O xml seguinte é o que se crea por defecto cando se crea un novo proxecto:
<syntaxhighlight lang="xml" line enclose="div" highlight="7,8,9" >
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:context="com.example.u5_01_menus.U5_01_Menus" >

    <item
        android:id="@+id/action_settings"
        android:orderInCategory="100"
        android:showAsAction="never"
        android:title="@string/action_settings"/>

</menu>
</syntaxhighlight>
*'''Liña 7''': o atributo '''android:orderInCategory="Nº Enteiro"'''. Se hai varios ítems indica cal aparecerá primeiro, segundo, etc. Se todos teñen o mesmo valor entón aparecen na orde na que son creados. 


*'''Liña 8''': o atributo '''android:showAsAction''' pode ter os seguintes valores:
**'''never''': nunca amosa o item de menú na barra de acción.
**'''ifRoom''': se hai espazo na barra de acción o amosa.
**'''always''': amosa sempre na barra de acción.
**'''withText''': se temos unha icona, por defecto non amosa o texto. Se queremos que amose os dúos poñeremos este valor.
**'''collapseActionView''': cando a acción dun elemento de menú (declarada coma '''android:actionLayout''' ou '''android:actionViewClass''') é plegable. Dispoñible a'partires da versión API 14.
**Os elementos de menú que aparecen na barra, xa non aparecen no menú o premer o botón Menú ou "OverFlow", aínda que estean nun group, como se pode apreciar nas imaxes de abaixo.
**Os valores pódense combinar có caracter ‘|’.


*'''Liña 9''': o atributo '''android:title''' indica o nome do menú/submenú. Neste caso o seu valor defínese nun recurso xml de strings:
<syntaxhighlight lang="xml" line enclose="div" highlight="6" >
<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="app_name">U5_01_Menus</string>
    <string name="hello_world">Hello world!</string>
    <string name="action_settings">Settings</string>

</resources>
</syntaxhighlight>


*O atributo '''android:onClick''' funciona igual que nas vistas do recurso xml do Layout.


*'''EXEMPLO DE MENÚ NA BARRA DE ACCIÓN CON SUBMENUS''' 
*A seguinte imaxe, obténse co seguinte recurso xml.
[[Image:Android_2014_U5_01_Menus_09.jpg|350px]]

<syntaxhighlight lang="xml" line enclose="div" highlight="6,7,9,10-23,27,28,30,34,35,37" >
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android" >

    <item
        android:id="@+id/itemAbrir"
        android:icon="@drawable/open32"
        android:showAsAction="ifRoom"
        android:title="Abrir"
        android:titleCondensed="Abrir">
        <menu>
            <item
                android:id="@+id/itemDoc"
                android:title="Documento"
                android:titleCondensed="Doc."/>
            <item
                android:id="@+id/itemIma"
                android:title="Imaxes"
                android:titleCondensed="Imax."/>
            <item
                android:id="@+id/itemAudio"
                android:title="Audio"
                android:titleCondensed="Audio"/>
        </menu>
    </item>
    <item
        android:id="@+id/itemNovo"
        android:icon="@drawable/close32"
        android:showAsAction="ifRoom"
        android:title="Novo documento"
        android:titleCondensed="N.Doc.">
    </item>
    <item
        android:id="@+id/itemSair"
        android:icon="@drawable/exit32"
        android:showAsAction="ifRoom"
        android:title="Saír"
        android:titleCondensed="Saír">
    </item>

</menu>
</syntaxhighlight>

*'''Liñas 6,27,34''': Indican o recurso ''drawable'' que deben amosar. Estas imaxes deben estar na carpeta '''/res/drawableXXXXX''' correspondentes.
*'''Liñas 7,28,35''': Indican que se hai espazo na barra de acción que amosen eses ítems que teñen ese atributo.
*'''Liñas 9,30,37''': O atributo '''android:titleCondensed''' usarase cando o valor de '''android:title''' sexa demasiado longo.
*'''Liñas 10-23''': Para crear submenús dentro dun menú, volvemos a crear a entrada <menu> dentro de <item>


====Agrupamentos====
*Outro elemento que pode ir dentro do elemento '''<menu>''':
**'''<group>''': un grupo é un conxunto de elementos que teñen certas características.
***Amosar ou ocultar todos os elementos: '''setGroupVisible()'''
***Habilitar ou deshabilitar todos os elementos: '''setGroupEnabled()'''
***Facer que todos os ítems do group poidan ser presentados en forma de checkbox: '''setGroupCheckable()'''
****Podemos facer que un elemento sexa chequeable usando o atributo '''android:checkable''' no elemento <item> ou o
****group enteiro con ''''android:checkableBehavior''' no elemento <group>.
****O atributo '''android:checkableBehavior''' pode ter as seguintes opcións:
*****'''single''': só un elemento do grupo pode ser checkeado (radiobuttons).
*****'''all''': todos os elementos poden ser checkeados (checkboxs).
*****'''none''': ningún elemento é seleccionable.
****Se non poñemos nada, os elementos do <group> aparecen como os demais.


*A seguinte imaxe, ten asociado o seguinte XML.
*Observar que na barra de acción non collen todos os menús.
*Observar que hai dous menús (Modo Lectura e Modo Gravación) que poden ser marcados os dous.
[[Image:Android_2014_U5_01_Menus_10.jpg|300px]]

<syntaxhighlight lang="xml" line enclose="div" highlight="35,40-55" >
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android" >

    <item
        android:id="@+id/itemAbrir"
        android:icon="@drawable/open32"
        android:showAsAction="always"
        android:title="Abrir"
        android:titleCondensed="Abrir">
        <menu>
            <item
                android:id="@+id/itemDoc"
                android:title="Documento"
                android:titleCondensed="Doc."/>
            <item
                android:id="@+id/itemIma"
                android:title="Imaxes"
                android:titleCondensed="Imax."/>
            <item
                android:id="@+id/itemAudio"
                android:title="Audio"
                android:titleCondensed="Audio"/>
        </menu>
    </item>
    <item
        android:id="@+id/itemNovo"
        android:icon="@drawable/close32"
        android:showAsAction="ifRoom"
        android:title="Novo documento"
        android:titleCondensed="N.Doc.">
    </item>
    <item
        android:id="@+id/itemSair"
        android:icon="@drawable/exit32"
        android:showAsAction="ifRoom"
        android:title="Saír"
        android:titleCondensed="Saír">
    </item>

    <group
        android:id="@+id/mgrpModos"
        android:checkableBehavior="all" >
        <item
            android:id="@+id/ModoLect"
            android:showAsAction="ifRoom"
            android:title="Modo Lectura"
            android:titleCondensed="M.Lect.">
        </item>
        <item
            android:id="@+id/ModoRecord"
            android:showAsAction="ifRoom"
            android:title="Modo Grabación"
            android:titleCondensed="M.Grab">
        </item>
    </group>

</menu>
</syntaxhighlight>
*'''Liñas 35,45,51''': Observar como estes ítems non se amosan na barra de acción porque non teñen espazo.
*'''Liñas  40-55''': Observar como hai un agrupamento de ítems e na '''liña 42''' indícase que todos eles son "chequeables".


===Lanzar e procesar o menú===
*Para lanzar o menú debemos cambiar o menú que ten asinada unha determinada Activity e para iso temos que sobrescribir o método '''onCreateOptionsMenu()'''.
*Este método xa aparece na Activity cando a creamos con Eclipse.
*O que facemos en "inflar" o xml asociado ao menú (Liña 4) do mesmo xeito que se fai cando se 
<syntaxhighlight lang="java" line enclose="div" highlight="4" >
   @Override
        public boolean onCreateOptionsMenu(Menu menu) {
                // Inflate the menu; this adds items to the action bar if it is present.
                getMenuInflater().inflate(R.menu.u5_01__menus, menu);
                return true;
        }
 
</syntaxhighlight>



*Cando se preme un ítem dun menú lánzase o evento onOptionsItemSelected e para procesar ese ítem  sobrescribir o método  '''onOptionsItemSelected(MenuItem item)'''.
*Este método tamén se crea por defecto ao crear o proxecto.
<syntaxhighlight lang="java" line enclose="div" highlight="9,11" >
        @Override
        public boolean onOptionsItemSelected(MenuItem item) {
                // Handle action bar item clicks here. The action bar will
                // automatically handle clicks on the Home/Up button, so long
                // as you specify a parent activity in AndroidManifest.xml.
 
               	int id = item.getItemId();
		if (id == R.id.action_settings) {
			return true;
		}
		return super.onOptionsItemSelected(item);
          }
</syntaxhighlight>
*Este método devolve un boolean:
**true: se procesamos un elemento do menú (return true).
**false: se non o procesamos (chamar ao método pai).

===Caso pŕactico===


*Crear o proxecto: '''U5_01_Menus'''

<gallery caption="Menús básicos" widths="350" heights="300px" perrow="2">
Image:Android_2014_U5_01_Menus_01.jpg| Observar como temos unha icona na barra de acción (a cara) e o menú "overflow"
Image:Android_2014_U5_01_Menus_02.jpg| Se prememos na cara realízase unha acción, neste caso cambiouse o texto do TextView e lanzaouse un Toast.
Image:Android_2014_U5_01_Menus_03.jpg| Se prememos no menú "overflow" obtemos outros 2 menús ...
Image:Android_2014_U5_01_Menus_04.jpg| Os mesmos que se premmos no botón menú da Botonera dos dispositivos que a teñan.
Image:Android_2014_U5_01_Menus_05.jpg| Se prememos en calquera dos dous casos anteriores no menú "Opción2" lánzase un Toast e cambiouse o texto do TextView.
Image:Android_2014_U5_01_Menus_06.jpg| Se prememos na "Opcion 3 - Submenús" obtemos os submenús asociados a ese ítem.<br> Podemos:<br> Lanzar a calculadora ou <br> saír da aplicación.
Image:Android_2014_U5_01_Menus_07.jpg| Neste caso lanzouse a calculadora e un Toast.
</gallery>
 

====As imaxes dos menús====
*Neste caso colocouse en cada recurso '''res/drawable''' a imaxe da cara:
[[Image:Android_2014_U5_01_Menus_11.jpg]]



*Esta imaxe pode obterse do seguinte zip: [[media:Res.zip]] e unha vez descomprimido pódese copiar tal cal ao proxecto a "res"
*Estas imaxes e outras poden obterse de:
**http://www.androidicons.com/
**http://www.glyfx.com/content/page/android-common-ii.html


====Recursos XML====
*O xml do '''Layout''':

*É o creado por defecto salvo que lle engadimos un id (Liñas 11).
<syntaxhighlight lang="xml" line enclose="div" highlight="11" >
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin">

    <TextView
        android:id="@+id/tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/hello_world" />

</RelativeLayout>
</syntaxhighlight>


*O xml do '''menú''' (modificamos o recurso XML creado por defecto en /res/menu/...)

<syntaxhighlight lang="xml" line enclose="div" highlight="8,9,13,14,19,20" >
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:context="com.example.u5_01_menus.U5_01_Menus" >

    <item
        android:id="@+id/item1"
        android:icon="@drawable/ic_action_emo_basic"
        android:orderInCategory="100"
        android:showAsAction="always"
        android:title="@string/item1"/>
    <item
        android:id="@+id/item2"
        android:orderInCategory="100"
        android:showAsAction="never"
        android:title="@string/item2"/>
    <item
        android:id="@+id/item3"
        android:orderInCategory="100"
        android:showAsAction="never"
        android:title="@string/item3">
        <menu>
            <item
                android:id="@+id/SubItem3_1"
                android:title="@string/item3_1"/>
            <item
                android:id="@+id/SubItem3_2"
                android:title="@string/item3_2"/>
        </menu>
    </item>
</menu>
</syntaxhighlight>
*'''Liñas 8,13,18''': Observar como todos os ítems teñen o mesmo valor para a ser ordenados. 
**Que o participante no curso probe a cambiar o terceiro ítem a un valor de 99.
*'''Liñas 9,14,19''': Observar como o primeiro ítem indica always e os demais never á hora de amosar o menú na barra de acción.


*Recurso xml de '''strings'''
*Aínda que podíamos poñer os Títulos dos menús directamente no ficheiro anterior, decidimos, nesta ocasión, realizalo da maneira recomendada: definir os seus valores nun recurso xml.

<syntaxhighlight lang="xml" line enclose="div" highlight="6-10" >
<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="app_name">U5_01_Menus</string>
    <string name="hello_world">Hello world!</string>
    <string name="item1">Opción 1</string>
    <string name="item2">Opción 2</string>
    <string name="item3">Opción 3- Submenús</string>
    <string name="item3_1">Opción 3- Submenú 1 - Calculadora</string>
    <string name="item3_2">Opción 3- Submenú 2 - Saír</string>

</resources>
</syntaxhighlight>

====O código java da aplicación====

<syntaxhighlight lang="java" line enclose="div" highlight="38-62" >
package com.example.u5_01_menus;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.TextView;
import android.widget.Toast;

public class U5_01_Menus extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_u5_01__menus);
	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.u5_01__menus, menu);
		return true;
	}

	@Override
	public boolean onOptionsItemSelected(MenuItem item) {
		// Handle action bar item clicks here. The action bar will
		// automatically handle clicks on the Home/Up button, so long
		// as you specify a parent activity in AndroidManifest.xml.
	/*
		int id = item.getItemId();
		if (id == R.id.action_settings) {
			return true;
		}
		return super.onOptionsItemSelected(item);
 	*/
		TextView tv = (TextView) findViewById(R.id.tv);
		Toast.makeText(getApplicationContext(), "Pulsado elemento: " + item.getTitle().toString(), Toast.LENGTH_SHORT).show();

		switch (item.getItemId()) {
		case R.id.item1:
			tv.setText("Quedarei con esta cara de sorriso cando remate esta tarefa");
			return true;

		case R.id.item2:
			tv.setText("A opción 2 non ten nada asignado");
			return true;

		case R.id.SubItem3_1:
			Intent intent = new Intent();
			intent.setClassName("com.android.calculator2", "com.android.calculator2.Calculator");
			startActivity(intent);
			return true;

		case R.id.SubItem3_2:
			finish();
			return true;
		default:
			return super.onOptionsItemSelected(item);

		}
	}

	public void finish() {
		super.finish();
	}

}
</syntaxhighlight>
*'''Liña 39''': Recollemos o título do ítem pulsado.
*'''Liñas 44,48,54,58''': devolver true no caso de procesar cada un dos ítems.
*'''Liña 60''': Se non se procesou o ítem chamar ao pai, que vai devolver false por defecto.



*Se na definición de cada ítem se houbera usado o atributo '''android:onClick''' entón teríamos que crear en java os métodos correspondentes do mesmo xeito que se fai cando se usa ese atributo nun Layout.



==Menús contextuais==
*Pódense crear sobre calquera elemento View, pero normalmente vanse usar con ListView e GridView.*
*Existen dúas formas de implantar este tipo de menús:
*'''Menú contextual flotante''':
*O menú aparece cando o usuario prema durante un tempo longo un elemento e aparece unha lista.
[[Image:Android_2014_U5_02_MenusContextuais_01.jpg]]


Para crear este tipo de menú:
*O View que queira usalo ten que ser asociado ao mesmo chamando o método '''registerForContextMenu''' pasando o obxecto View.
*Se todos os elementos do ListView / GridView teñen o mesmo menú contextual, se pode pasar como parámetro o ListView / GridView.
*Por exemplo (isto se fai no método onCreate): '''registerForContextMenu(lista);'''
**Sendo lista a referencia a unha ListView.

*Implantar o método '''onCreateContextMenu()''' na Activity / Fragment.
**Este método será chamado de forma automática cando o usuario preme durante un tempo o elemento (View) asociado o ContextMenu.
**O que fai este método é amosar o menú contextual creado por nós previamente.

<syntaxhighlight lang="java" line enclose="div" highlight="5" >
@Override
public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
    super.onCreateContextMenu(menu, v, menuInfo);
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.context_menu, menu);
}
</syntaxhighlight>
*Lembrar que o MenuInflater serve para pasar dun arquivo XML (o menú contextual definido por nós) a obxectos MenuItems.



*Implantar o método '''onContextItemSelected()''' ao que se chama de forma automática cando se selecciona algo do menú contextual

<syntaxhighlight lang="java" line enclose="div" highlight="3,4" >
        @Override
	public boolean onContextItemSelected(MenuItem item) {
		AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
		switch (item.getItemId()) {
		case R.id.edit:
			editNote(info.id);
			return true;
		case R.id.delete:
			deleteNote(info.id);
			return true;
		default:
			return super.onContextItemSelected(item);
		}
	}
</syntaxhighlight>
*'''Liña 3'''. Do ítem pulsado recibimos información extra, entre outras, o "id" e a "posición" do ítem do adaptador sobre o que se pulsou durante un tempo para crear o menú contextual.
**Ese "id" e "posición" son recollidos na variable info de tipo AdapterContextMenuInfo. 
*'''Liña 4''': fixarse que é '''item.getItemId()''' para obter referencia ao id do menú contextual que foi seleccionado. Non confundir co id do elemento do adaptador sobre o que foi creado ese menú contextual.
*O resto funciona igual que non menú básico.


*'''Menú de modo acción contextual''':
*Neste caso, o menú aparece nunha barra de acción contextual na parte superior da pantalla (só dispoñible a partires da versión 3.0 API11).[[Image:Android_2014_U5_02_MenusContextuais_02.jpg]]

*O funcionamento é semellante ao anterior e deixamos para o participante no curso o seguinte enlace para que afonde no seu funcionamento: 
**http://developer.android.com/guide/topics/ui/menus.html#CAB

===Menú contextual: Caso Práctico===
*Neste caso vanse crear dous menús contextuais distintos:
**un para unha etiqueta (TextView) 
**e outro para unha lista (ListView).

*Crear o proxecto: '''U5_02_MenusContextuais'''
<gallery caption="Creación dunha segunda Activity" widths="350" heights="300px" perrow="2">
Image:Android_2014_U5_02_MenusContextuais_03.jpg| A aplicación ten unha etiqueta de texto (Hello world!) e unha lista.
Image:Android_2014_U5_02_MenusContextuais_04.jpg| Se prememos durante un anaco sobre a etiqueta de texto aparece o menú contextual da imaxe. Se seleccionamos a primeira opción dese menú contextual ...
Image:Android_2014_U5_02_MenusContextuais_05.jpg| ... obtemos un Toast que nos di que seleccionamos esa opción.
Image:Android_2014_U5_02_MenusContextuais_06.jpg| Se prememos por un anaco sobre un elemento da lista, por exemplo sobre Mango, obtemos outro menú contextual distinto. Se prememos na opción borrar ...
Image:Android_2014_U5_02_MenusContextuais_07.jpg| ... bórrase o elemento da lista
Image:Android_2014_U5_02_MenusContextuais_08.jpg| Se prememos por un anaco de tempo sobre outro elemento, por exemplo Laranxa, e seleccionamos Duplicar do menú contextual ...
Image:Android_2014_U5_02_MenusContextuais_09.jpg| ... duplicamos o elemento na lista.
</gallery>


===Menú contextual: O XML do Layout===

*Conservamos o TextView que vén por defecto e engadimos un ListView. 
*Ao TextView engadímoslle un id.
<syntaxhighlight lang="xml" line enclose="div" highlight="41" >
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="@dimen/activity_vertical_margin" >

    <TextView
        android:id="@+id/tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/hello_world" />

    <ListView
        android:id="@+id/lvFroitas"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" >
    </ListView>

</LinearLayout>
</syntaxhighlight>

===Menú contextual: O XML dos menús contextuais===
*Imos crear dous recursos xml para cada un dos menús contextuais distintos que temos segundo premamos sobre un TextView ou sobre un ListView.
*Poderían ser o mesmo menú contextual, pero así aprendemos que estes poden ser distintos en función da View ao que se asocien.

[[Image:Android_2014_U5_02_MenusContextuais_10.jpg]]

*'''O xml de /res/menu/menu_contextual_etiqueta.xml'''
<syntaxhighlight lang="xml" line enclose="div" highlight="41" >
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android" >

    <item
        android:id="@+id/tvItem1"
        android:showAsAction="withText"
        android:title="TextView opción 1">
    </item>
    <item
        android:id="@+id/tvItem2"
        android:showAsAction="withText"
        android:title="TextView opción 2">
    </item>

</menu>
</syntaxhighlight>


*'''O xml de /res/menu/menu_contextual_lista.xml'''
<syntaxhighlight lang="xml" line enclose="div" highlight="41" >
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android" >

    <item
        android:id="@+id/lvItemBorrar"
        android:showAsAction="withText"
        android:title="Borrar">
    </item>
    <item
        android:id="@+id/lvItemDuplicar"
        android:showAsAction="withText"
        android:title="Duplicar">
    </item>
</menu>
</syntaxhighlight>


*Observar que nos dous ficheiros xml cada item ten asociado un "id", para logo ser identificado o ítem cando sexa procesado no código.




===Menú contextual: o código Java da aplicación===
<syntaxhighlight lang="java" line enclose="div" highlight="30,55-69, 71-83,85-116" >
package com.example.u5_02_menuscontextuais;

import java.util.ArrayList;
import java.util.Arrays;
import android.app.Activity;
import android.os.Bundle;
import android.view.ContextMenu;
import android.view.ContextMenu.ContextMenuInfo;
import android.view.Menu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.view.View;
import android.widget.AdapterView.AdapterContextMenuInfo;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;

public class U5_02_MenusContextuais extends Activity {
	ListView lv;
	TextView tv;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_u5_02__menus_contextuais);

		lv = (ListView) findViewById(R.id.lvFroitas);
		tv = (TextView) findViewById(R.id.tv);
		registerForContextMenu(tv);

		engadirDatosListView();

	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.u5_02__menus_contextuais, menu);
		return true;
	}

	@Override
	public boolean onOptionsItemSelected(MenuItem item) {
		// Handle action bar item clicks here. The action bar will
		// automatically handle clicks on the Home/Up button, so long
		// as you specify a parent activity in AndroidManifest.xml.
		int id = item.getItemId();
		if (id == R.id.action_settings) {
			return true;
		}
		return super.onOptionsItemSelected(item);
	}

	private void engadirDatosListView() {
		String[] froitas = new String[] { "Laranxa", "Mango", "Ameixa" };

		ArrayList<String> alFroitas = new ArrayList<String>();

		alFroitas.addAll(Arrays.asList(froitas));

		ArrayAdapter<String> adaptador = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, alFroitas);

		adaptador.setDropDownViewResource(android.R.layout.simple_list_item_1);

		lv.setAdapter(adaptador);

		registerForContextMenu(lv);
	}

	@Override
	public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
		super.onCreateContextMenu(menu, v, menuInfo);
		MenuInflater inflater = getMenuInflater();

		// Comprobamos se o menú contextual se lanzou sobre a etiqueta ou sobre
		// a lista
		if (v.getId() == R.id.tv)
			inflater.inflate(R.menu.menu_contextual_etiqueta, menu);

		else if (v.getId() == R.id.lvFroitas)
			inflater.inflate(R.menu.menu_contextual_lista, menu);
	}

	@Override
	public boolean onContextItemSelected(MenuItem item) {
		AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
		ArrayAdapter<String> adaptador = (ArrayAdapter<String>) lv.getAdapter();

		switch (item.getItemId()) {

		// Ítems premidos sobre o TextView
		// Lanza un Toast coa opción do menú contextual que se seleccinou
		case R.id.tvItem1:
			Toast.makeText(this, "Menú contextual TextView:\n"+item.getTitle(), Toast.LENGTH_SHORT).show();
			return true;

		case R.id.tvItem2:
			Toast.makeText(this, "Menú contextual TextView:\n"+item.getTitle(), Toast.LENGTH_SHORT).show();
			return true;

		// Ítems premidos sobre o ListView
		case R.id.lvItemBorrar:
			adaptador.remove(adaptador.getItem(info.position));
			adaptador.setNotifyOnChange(true);
			return true;

		case R.id.lvItemDuplicar:
			adaptador.add(adaptador.getItem(info.position));
			adaptador.setNotifyOnChange(true);

			return true;
		default:
			return super.onContextItemSelected(item);
		}
	}

}
</syntaxhighlight>

*'''Liña 30''': indicamos que TextView vai ter un menú contextual asociado.

*'''Liñas 55-69''': Creamos un Array estático que logo asignamos a un dinámico.
**'''Liña 62''': usamos o array dinámico para logo en tempo de execución poder engadir/borrar elementos do adaptador e por tanto do ListView.
**'''Liña 68''': indica que o ListView de froitas vai ter un menú contextual asociado.


*'''Liñas 71-83''': '''onCreateContexMenu()''' vai ser chamado cando se prema durante un anaco sobre unha view, neste caso comprobamos sobre que view se premeu e lánzase ("inflase") o correspondente menú contextual, cada un deles definido nun ficheiro xml distinto.


*'''Liñas 85-116''': En función do id do ítem premido realizamos unhas accións ou outras como no caso dos menús básicos. Só que neste caso os ids proveñen de ítems de menús declarados en 2 ficheiros distintos.


====Personalizar título do menú contextual====
*Se queremos que o menú contextual teña un título debemos usar o método: '''setHeaderTitle()

*As seguintes imaxes amosan un exemplo para o caso do TextView e o ListView:

<gallery caption="Títulos para os menús contextuais" widths="350" heights="300px" perrow="2">
Image:Android_2014_U5_02_MenusContextuais_11.jpg| Neste caso o título do menú contextual é "Etiqueta de texto"
Image:Android_2014_U5_02_MenusContextuais_12.jpg| Neste outro é o título do ítem do ListView sobre o que se premeu.
</gallery>



*Os cambios a realizar no '''código Java''' son os seguintes:
*No memento no que hai que crear o menú contextual:
<syntaxhighlight lang="java" line enclose="div" highlight="9,14" >
@Override
	public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
		super.onCreateContextMenu(menu, v, menuInfo);
		MenuInflater inflater = getMenuInflater();

		// Comprobamos se o menú contextual se lanzou sobre a etiqueta ou sobre
		// a lista
		if (v.getId() == R.id.tv){
			menu.setHeaderTitle("Etiqueta de texto");
			inflater.inflate(R.menu.menu_contextual_etiqueta, menu);
		}
		else if (v.getId() == R.id.lvFroitas) {
			AdapterView.AdapterContextMenuInfo info = (AdapterView.AdapterContextMenuInfo) menuInfo;
			menu.setHeaderTitle(lv.getAdapter().getItem(info.position).toString());
			inflater.inflate(R.menu.menu_contextual_lista, menu);
		}
	}

</syntaxhighlight>
*'''Liñas 9,14''': establecemos o título para o menú contextual.


 

<br> -- [[Usuario:angelfg|Ángel D. Fernández González]] e [[Usuario:Carrion|Carlos Carrión Álvarez]] -- (2015).