Carrion: Página creada con «==Introdución== En Android hai moitas formas de interceptar eventos do usuario. A clase View proporciona varias formas de xestionar eventos. *Por exemplo cando un usuari...»

2013-11-14T07:14:13Z

Página creada con «==Introdución== *En Android hai moitas formas de interceptar eventos do usuario. *A clase View proporciona varias formas de xestionar eventos. *Por exemplo cando un usuari...»

Página nueva

==Introdución==
*En Android hai moitas formas de interceptar eventos do usuario.
*A clase View proporciona varias formas de xestionar eventos.
*Por exemplo cando un usuario toca un botón e chamado o método callback onTouchEvent() dese obxecto.
*Pero para interceptar ese evento debemos estender a clase e implementar o método.
*Pero non sería práctico para poder manexar o evento crear unha (sub)clase para cada obxecto Vista.
*Por iso a Clase Vista conten unha colección de interfaces anidadas.
*Estas interfaces chámanse '''Event Listeners (Escoitadores de eventos)''' e están listas para capturar a iteración do usuario coa UI.

*A continuación imos ver algunhas formas de capturar eventos:

*'''Referencias'''
**http://developer.android.com/guide/topics/ui/ui-events.html

==Caso práctico==
*Comezamos creando o proxecto: '''U3_02_Eventos'''
*Comezaremos capturado o evento '''Click''' e logo ao final veremos outros eventos.

*A aplicación coa que se traballará é a seguinte:
[[Image:Android_2013_U3_02_Eventos_01.jpg]]

===XML do Layout===
*A liña 11 marca unha das formas máis sinxelas de capturar o evento Click sobre un compoñente.
<syntaxhighlight lang="xml" line enclose="div" highlight="11" >
<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">

<Button
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Botón1: onClick Layout"
android:onClick="onBotonClick"
/>

<Button
android:id="@+id/boton2"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Botón2: Listener"
/>

<Button
android:id="@+id/boton3"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Botón3: Clase"
/>

<Button
android:id="@+id/boton4"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Botón4: Tamén de clase"
/>

<Button
android:id="@+id/boton5"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Botón5: Obxecto"
/>

<Button
android:id="@+id/boton6"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Botón6: Outro Obxecto"
/>
</LinearLayout>

</syntaxhighlight>

===O Código Java===
*A continuación preséntase o código Java, pero este vai ser debullado nos seguintes apartados.

<syntaxhighlight lang="java" line enclose="div" highlight="0" >
package com.example.u3_02_eventos;

import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

public class U3_02_Eventos extends Activity {

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

Button boton2 = (Button) findViewById(R.id.boton2);
boton2.setOnClickListener(new OnClickListener() {

@Override
public void onClick(View v) {
Toast.makeText(getApplicationContext(), "Premeches o Botón2", Toast.LENGTH_SHORT).show();
}
});

Button boton3 = (Button) findViewById(R.id.boton3);
boton3.setOnClickListener(new XestionEventos());

Button boton4 = (Button) findViewById(R.id.boton4);
boton4.setOnClickListener(new XestionEventos());

Button boton5 = (Button) findViewById(R.id.boton5);
boton5.setOnClickListener(_OnClickListener);

Button boton6 = (Button) findViewById(R.id.boton6);
boton6.setOnClickListener(_OnClickListener);

}

private OnClickListener _OnClickListener = new OnClickListener() {

@Override
public void onClick(View v) {
Button btn = (Button) v;
Toast.makeText(v.getContext(), "Premeches" + btn.getText(), Toast.LENGTH_SHORT).show();
}
};

public void onBotonClick(View v) {
Toast.makeText(this, "Premeches o Botón1", Toast.LENGTH_SHORT).show();
}

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

}

</syntaxhighlight>

===Propiedade android:onClick===
*Como xa se view é unha propiedade XML que teñen varios compoñentes (vistas).
*Hai que definir un método:
**Que sexa public
**Que non devolva nada: void
**Que teña un parámetro da clase View, que será quen provoque o evento.
*No exemplo anterior son as liñas 50-52:

<syntaxhighlight lang="java" line enclose="div" highlight="1" >
public void onBotonClick(View v) {
Toast.makeText(this, "Premeches o Botón1", Toast.LENGTH_SHORT).show();
}
</syntaxhighlight>

===Listener===
*Un Event Listener es una interface da clase Vista (View) que contén un único método de tipo callback que hai que implmentar
*Android invoca estes métodos cando a Vista detecta que o usuario está provocando un tipo concreto de interacción con este elemento da interface de usuario.

Existen os seguintes métodos callback:
**'''onClick()''': de '''View.OnClickListener'''. Este método invócase cando o usuario toca un elemento cun dedo (modo contacto), fai click coa bola de navegación (TrackBall) do dispositivo ou preme a tecla "Enter" estando nun compoeñente.
**'''onLongClick()''': de '''View.OnLongClickListener'''. Este método chámase cando o usuario toca e mantén o dedo sobre un elemento (modo de contacto), fai click sen soltar coa bola de navegación (TrackBall) ou preme a tecla "Enter" perante un segundo estando nun elemento.
**'''onFocusChange()''': de '''View.OnFocusChangeListener'''. Invócase cando o usuario move o cursor cara unha Vista ou se alonxa desta utilizando a bola de navegación ou usando as teclas de navegación.
'''onKey()''': de '''View.OnKeyListener'''. Chámase cando o usuario se centra nun elemento e presiona ou libera una tecla do dispositivo.
**...
*'''onLongClick()''' verase nun exemplo posterior.

*Estes métodos son os únicos que se van implementar nas súas respectivas interfaces.
*Estas interfaces teñen o formato: '''on...Listener()'''
*Unha vez que temos implementada a interface témoslla que pasar como parámetro á vista (view) correspondente a través de '''vista.set...Listener()'''.

====A través dunha clase anónima====
*Exemplo: '''Liñas 18-25''' do código
<syntaxhighlight lang="java" line enclose="div" highlight="0" >
Button boton2 = (Button) findViewById(R.id.boton2);
boton2.setOnClickListener(new OnClickListener() {

@Override
public void onClick(View v) {
Toast.makeText(getApplicationContext(), "Premeches o Botón2", Toast.LENGTH_SHORT).show();
}
});
</syntaxhighlight>

====Implementar a interface a través dunha clase====
*Creamos unha nova clase que implemente onClickListener
[[Image:Android_2013_U3_02_Eventos_02.jpg]]

*Código Java da clase: '''XestionEventos'''
<syntaxhighlight lang="java" line enclose="div" highlight="1" >
package com.example.u3_02_eventos;

import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

public class XestionEventos implements OnClickListener {

@Override
public void onClick(View v) {
// TODO Auto-generated method stub

Button btn = (Button) v;
Toast.makeText(v.getContext(), "Premeches "+btn.getText(), Toast.LENGTH_SHORT).show();
}
}
</syntaxhighlight>

*Observar nas Liñas 28 e 31 (do código principal) como se crea unha nova clase XestionEventos para cada botón.
*Esa clase é a que vai implementar o método onClick(), como se ve enriba.

<syntaxhighlight lang="java" line enclose="div" highlight="1" >

Button boton3 = (Button) findViewById(R.id.boton3);
boton3.setOnClickListener(new XestionEventos());

Button boton4 = (Button) findViewById(R.id.boton4);
boton4.setOnClickListener(new XestionEventos());

</syntaxhighlight>

*Pero esta forma é un ''engorro'', pois hai que estar creando clases.

====Crear un obxecto que implemente a interface====
*Para rematar imos crear un obxecto que implemente a interface e que poida ser pasado como parámetro as vistas que desexemos cada vez que se fai click nelas.

*'''_OnClickLister''' é un obxecto de tipo OnClickListener.
<syntaxhighlight lang="java" line enclose="div" highlight="1" >
private OnClickListener _OnClickListener = new OnClickListener() {

@Override
public void onClick(View v) {
Button btn = (Button) v;
Toast.makeText(v.getContext(), "Premeches" + btn.getText(), Toast.LENGTH_SHORT).show();
}
};
</syntaxhighlight>

*Pasamos ese obxecto ás vistas que desexemos cando se faga Click nelas.
<syntaxhighlight lang="java" line enclose="div" highlight="1" >

Button boton5 = (Button) findViewById(R.id.boton5);
boton5.setOnClickListener(_OnClickListener);

Button boton6 = (Button) findViewById(R.id.boton6);
boton6.setOnClickListener(_OnClickListener);
</syntaxhighlight>

==onLongClick()==
*Cando sobre unha vista se preme por duración de 1 segundo o máis lánzase o evento '''LongClick''' que é capturado polo método '''onLongClick()''' asociado ao correspondente interface.

*O método onLongClick() devolve un booleano para poder comprobar se o evento se consumou ou non. Se chegamos a premer por un segundo (ou máis) ou non.
**Devolve '''true''' se puidemos capturar o evento e xa non fai nada máis.
**Devolve '''false''' se non se puido capturar o evento e continua chamando a outros escoitadores tipo on-Click.

===Caso Práctico===
*Comezamos creando o proxecto '''U3_03_OnLongClick'''

*Esta actividade ten 2 vistas:
**Un botón que se pode facer Click (usando a propiade do XML) e LongClick (capturado a través dun Listener)
**Unha etiqueta de texto (en 2 liñas) na que se pode facer Click (hai que habilitalo) e LongClick. Nos dos casos os eventos captúranse con cadanseu Listener.
[[Image:Android_2013_U3_03_OnLongClick_01.jpg]]

====XML do Layout====

*Observar a '''Liña 20''' onde se habilita o TextView para sexa ''clickable''.
*Agora poderíase engadir ao compoñente a propiedade: android:onClick="onBotonClick"
<syntaxhighlight lang="xml" line enclose="div" highlight="20" >
<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" >

<Button
android:id="@+id/boton"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:onClick="onBotonClick"
android:text="Botón:\n
onClick Layout\n
onLongClick Listener" />

<TextView
android:id="@+id/text_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:clickable="true"
android:text="Fai click e
\nPreme aquí por máis de 1 seg"
android:textSize="20sp" />

</LinearLayout>
</syntaxhighlight>

====Código Java====
<syntaxhighlight lang="java" line enclose="div" highlight="21-28,33-40,42-49" >
package com.example.u3_03_onlongclick;

import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.View.OnLongClickListener;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;

public class U3_03_OnLongClick extends Activity {

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

Button boton = (Button) findViewById(R.id.boton);
boton.setOnLongClickListener(new OnLongClickListener() {
@Override
public boolean onLongClick(View v) {
// TODO Auto-generated method stub
Toast.makeText(v.getContext(), "Premeches 1 seg no botón", Toast.LENGTH_SHORT).show();
return true;
}
});

TextView tv = (TextView) findViewById(R.id.text_view);
tv.setOnLongClickListener(new OnLongClickListener() {
@Override
public boolean onLongClick(View v) {
// TODO Auto-generated method stub
Toast.makeText(v.getContext(), "Premeches 1 seg na etiqueta de texto", Toast.LENGTH_SHORT).show();
return true;
}
});

tv.setOnClickListener(new OnClickListener() {

@Override
public void onClick(View v) {
// TODO Auto-generated method stub
Toast.makeText(v.getContext(), "Fixeches click na etiqueta de texto", Toast.LENGTH_SHORT).show();
}
});

}

public void onBotonClick(View v) {
Toast.makeText(this, "Fixeches Click no botón", Toast.LENGTH_SHORT).show();
}

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

}

</syntaxhighlight>
*'''Liñas 21-28''':
**Cando se faga un LongClick en ''boton'' este executará o método onLonClick() que devolverá true se se chegou a consumar o evento.
**Probar a cambiar a liña 26 a '''return false''' e executar a aplicación. Que pasa?

*'''Liñas 33-40''':
**Acontece o mesmo que no caso anterior so que para a etiqueta de texto.

*'''Liñas 42-49''':
**Se na etiqueta sucede o evento Click executase chámase ao Listener correspondente da etiqueta.

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

Xestion de eventos III. onLongClick - Historial de revisiones

Carrion: Página creada con «==Introdución== *En Android hai moitas formas de interceptar eventos do usuario. *A clase View proporciona varias formas de xestionar eventos. *Por exemplo cando un usuari...»

Carrion: Página creada con «==Introdución== En Android hai moitas formas de interceptar eventos do usuario. A clase View proporciona varias formas de xestionar eventos. *Por exemplo cando un usuari...»