EL RESTO DE LAS INTERFACES

En las útimas dos entregas, hemos visto el uso de dos componentes para el uso de menús, vimos la clase LIST y CHOICEGROUP; vimos que básicamente la diferencia entre ambas es que la clase LIST no está subordinada a la clase FORM; ésto es, que no es necesario crear primero un objeto tipo FORM para luego agregar el objeto LIST.



private Display display;

private List miLista;

...

display = Display.getDisplay(this);

miLista = new List("Opciones", List.IMPLICIT);
miLista.append("Altas", null);
miLista.append("Bajas", null);
miLista.append("Consultas", null);
miLista.append("Modificaciones", null);
miLista.append("Impresion", null);
...

display.setCurrent(miLista);



Mientras que un objeto CHOICEGROUP debe estar unido a un objeto FORM.



private Display miDisplay;
private Form miForma;
private ChoiceGroup miGrupo;

...

miDisplay = Display.getDisplay(this);
miForma = new Form("MENU PRINCIPAL");

...

miGrupo = new ChoiceGroup("Opciones: ", ChoiceGroup.EXCLUSIVE);
miGrupo.append("Altas", null);
miGrupo.append("Bajas", null);
miGrupo.append("Consultas", null);
miGrupo.append("Modificaciones", null);
miGrupo.append("Impresion", null);

...

miForma.append(miGrupo);

...
display.setCurrent(miLista);



Pero además de estas clases contamos con muchas otras más como...


Class Ticker

Util para mostrar mensajes en forma de una marquesina deslizándote lado a lado de la pantalla del usuario.


Class DateField

Util para manejar fechas, ya sea para despliegue o para solicitar al usuario que proporcione una fecha en específico.



Class ImageItem

Util para trabajar con archivos de imágenes en nuestra aplicación. Ya lo veremos más adelante pero con esta herramienta podremos agregarle un atractivo visual que lo haga más amigable y agradable para el usuario.


Class TextField

Util para manejar texto; que puede ser de despliegue solamente o bien, para pedir al usuario que teclee datos. Como pueden password, números, nombres, etc.



Hay que recordar que las clases gráficas de alto nivel, tienen la facilidad de que se adaptan al tipo de despliegue con que cuenta el dispositivo en el cual estamos trabajando.

En otras palabras, nosotros llamamos las clases y creamos los objetos en nuestra aplicación, pero la presentación visual queda bajo el control del hardware.



Veamos ahora, el uso de las clases que acabamos de mencionar, en un ejemplo.


import java.io.IOException;
import java.util.Date;
import javax.microedition.lcdui.Command;
import javax.microedition.lcdui.CommandListener;
import javax.microedition.lcdui.DateField;
import javax.microedition.lcdui.Display;
import javax.microedition.lcdui.Displayable;
import javax.microedition.lcdui.Form;
import javax.microedition.lcdui.Image;
import javax.microedition.lcdui.ImageItem;
import javax.microedition.lcdui.Item;
import javax.microedition.lcdui.ItemStateListener;
import javax.microedition.lcdui.TextField;
import javax.microedition.lcdui.Ticker;
import javax.microedition.midlet.MIDlet;
import javax.microedition.midlet.MIDletStateChangeException;


public class MIDOtros extends MIDlet implements CommandListener, ItemStateListener {
private Ticker miMarquesina;
private DateField miFecha;
private ImageItem miImagen;
private TextField miHumor;
private Image imgSerio, imgFeliz, imgTriste;
private Command Salir;
private Display miDisplay;
private Form miForma;


public MIDOtros() {
try {
imgSerio = Image.createImage("/serio.PNG");
imgFeliz = Image.createImage("/feliz.PNG");
imgTriste = Image.createImage("/triste.PNG");
} catch (IOException e) {
e.printStackTrace();
}


Date wHoy = new Date();
miDisplay = Display.getDisplay(this);
miFecha = new DateField("Dia de hoy",DateField.DATE);
miFecha.setDate(wHoy);
miHumor = new TextField("% de Animo", "50", 2, TextField.NUMERIC);
miMarquesina = new Ticker("Ejemplo de Graficos de Alto Nivel. Tutorial para el Desarrollo de aplicaciones en móviles, País México. Noviembre del 2008");
miForma = new Form("Otros Items");
Salir = new Command("Salir", Command.EXIT, 0);
miImagen = new ImageItem(null, imgSerio, 0, null);
miForma.setTicker(miMarquesina);
miForma.append(miFecha);
miForma.append(miImagen);
miForma.append(miHumor);
miForma.addCommand(Salir);
miForma.setCommandListener(this);
miForma.setItemStateListener(this);
}


protected void destroyApp(boolean arg0) throws MIDletStateChangeException {
}


protected void pauseApp() {
}


protected void startApp() throws MIDletStateChangeException {
this.miDisplay.setCurrent(this.miForma);
}


public void commandAction(Command arg0, Displayable arg1) {
if (arg0 == Salir){
try {
destroyApp(false);
} catch (MIDletStateChangeException e) {
e.printStackTrace();
}
notifyDestroyed();
}
}


public void itemStateChanged(Item arg0) {
if (arg0 == miHumor){
int wValor = Integer.parseInt(miHumor.getString());
if (wValor <> 70) {
miImagen.setImage(imgFeliz);
} else {
miImagen.setImage(imgSerio);
}
}
}
}
}



Como se observa, en esta aplicación manejamos archivos de imagen :


imgSerio = Image.createImage("/serio.PNG");
imgFeliz = Image.createImage("/feliz.PNG");
imgTriste = Image.createImage("/triste.PNG");



Que son archivos tipo PNG, este tipo nos permite manejar imágenes con una buena y razonable resolución y almacenarlos en poco espacio.
Bien, una vez compilado nuestro código; podemos ejecutarlo y verlo en acción.

LAS OPCIONES DEL USUARIO

En el post anterior hablamos de la clase LIST en J2ME, pero contamos además con otra clase, CHOICEGROUP.

clase ChoiceGroup

public class ChoiceGroup extends Item implements Choice

Un componente ChoiceGroup es un grupo de elementos que podemos seleccionar. Es prácticamente lo mismo que el componente List, pero dentro de un formulario.

Para construir un objeto ChoiceGroup realizaremos una llamada a su constructor con los siguientes parámetros:

ChoiceGroup(String etiqueta, int tipo)
ChoiceGroup(String etiq, int tipo, String[] elementos, Image[] imagenes)

Y ahora veamos un ejemplo de cómo se utiliza esta clase dentro de una aplicación.

MIDChoiceGroup.java

import javax.microedition.lcdui.Alert;
import javax.microedition.lcdui.ChoiceGroup;
import javax.microedition.lcdui.Command;
import javax.microedition.lcdui.CommandListener;
import javax.microedition.lcdui.Display;
import javax.microedition.lcdui.Displayable;
import javax.microedition.lcdui.Form;
import javax.microedition.lcdui.Item;
import javax.microedition.lcdui.ItemStateListener;
import javax.microedition.midlet.MIDlet;
import javax.microedition.midlet.MIDletStateChangeException;


public class MIDChoiceGroup extends MIDlet implements CommandListener, ItemStateListener {
private Display miDisplay;
private Form miForma;
private ChoiceGroup miGrupo;
private Command Salir;

public MIDChoiceGroup() {
// TODO Auto-generated constructor stub
miDisplay = Display.getDisplay(this);
miForma = new Form("MENU PRINCIPAL");
Salir = new Command("Salir", Command.EXIT, 0);

miGrupo = new ChoiceGroup("Opciones: ", ChoiceGroup.EXCLUSIVE);
miGrupo.append("Altas", null);
miGrupo.append("Bajas", null);
miGrupo.append("Consultas", null);
miGrupo.append("Modificaciones", null);
miGrupo.append("Impresion", null);

miForma.append(miGrupo);
miForma.addCommand(Salir);
miForma.setItemStateListener(this);
miForma.setCommandListener(this);
}

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {
// TODO Auto-generated method stub

}

protected void pauseApp() {
// TODO Auto-generated method stub

}

protected void startApp() throws MIDletStateChangeException {
// TODO Auto-generated method stub
miDisplay.setCurrent(miForma);
}
public void commandAction(Command c, Displayable s) {
// TODO Auto-generated method stub
if (c == Salir){
try {
this.destroyApp(false);
notifyDestroyed();
} catch (MIDletStateChangeException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}

public void MuestraMensaje(){
Alert miAlerta = new Alert("Opcion", miGrupo.getString(miGrupo.getSelectedIndex()), null, null);
miDisplay.setCurrent(miAlerta, miForma);
}

public void itemStateChanged(Item i){
if (i == miGrupo){
this.MuestraMensaje();
}
}
}

EMPECEMOS POR LA PANTALLA

OPCIONES PARA EL USUARIO

Parte importante de toda interface de usuario, es que se pueda elegir la acción que se desea realizar. Ya sea por menús contextuales o barras en la parte superior o inferior de la pantalla; pero el usuario debe poder seleccionar la acción a realizar de entre un rango definido de tareas.

En el caso de J2ME se pueden utilizar las clases LIST y CHOICEGROUP; veamos una por una y un ejemplo para su uso correcto.

• CLASE List
  
  public class List extends Screen implements Choice
  
  La clase List nos va a permitir construir pantallas que poseen una lista de opciones. Esto nos será muy útil para crear menús de manera independiente.
  La clase List implementa la interfaz Choice, para poder interactuar con las distintas opciones que se muestre en una lista (List).

Otra parte importante de toda interface gráfica, es la comunicación Aplicación-Usuario; en otras palabras, que la aplicación pueda comunicarse con el usuario en caso de ocurrir algún error, dar una advertencia o informar de algun suceso.

en J2ME se usa mucho la class Alert para encargarse de ésto.

• CLASE Alert
  
  public class Alert extends Screen
  
  El objeto Alert representa una pantalla de aviso. Normalmente se usa cuando queremos avisar al usuario de una situación especial como, por ejemplo, un error.
  Un Alert está formado por un título, texto e imágenes si queremos. Vamos a ver como crear una pantalla de alerta. Para ello contamos con dos constructores:
  
  Alert(String titulo)
  Alert(String titulo, String textoalerta, Image imagen, AlertType tipo)
  
  Además podemos definir el tiempo que queremos que el aviso permanezca en pantalla, diferenciando de esta manera dos tipos de Alert:
  
  1. Modal: La pantalla de aviso permanece un tiempo indeterminado hasta que es cancelada por el usuario. Esto lo conseguimos invocando al método Alert.setTimeOut(Alert.FOREVER).
  
  2. No Modal: La pantalla de aviso permanece un tiempo definido por nosotros. Para ello indicaremos el tiempo en el método setTimeOut(tiempo). Una vez finalizado el tiempo, la pantalla de aviso se eliminará de pantalla y aparecerá el objeto Displayable que nosotros definamos.
  
  Podemos elegir el tipo de alerta que vamos a mostrar y cada tipo de alerta tiene asociado un sonido. Los tipos que podemos definir aparecen a continuación:
  
  ALARM Aviso de una petición previa
  CONFIRMATION Indica la aceptación de una acción
  ERROR Indica que ha ocurrido un error
  INFO Indica algún tipo de información
  WARNING Indica que puede ocurrir algún problema

Ahora veamos un ejemplo en acción:

MIDListas.java

import javax.microedition.lcdui.Alert;
import javax.microedition.lcdui.Command;
import javax.microedition.lcdui.CommandListener;
import javax.microedition.lcdui.Display;
import javax.microedition.lcdui.Displayable;
import javax.microedition.lcdui.List;
import javax.microedition.midlet.MIDlet;
import javax.microedition.midlet.MIDletStateChangeException;


public class MIDListas extends MIDlet implements CommandListener {
private Command salir, acepta;
private Display display;
private List miLista;
private Alert miAlerta;

public MIDListas() {

display = Display.getDisplay(this);

salir = new Command("Salir", Command.EXIT, 2);
acepta = new Command("Aceptar", Command.OK, 1);

miLista = new List("Opciones", List.IMPLICIT);
miLista.append("Altas", null);
miLista.append("Bajas", null);
miLista.append("Consultas", null);
miLista.append("Modificaciones", null);
miLista.append("Impresion", null);
miLista.addCommand(salir);

miLista.addCommand(salir);
miLista.addCommand(acepta);
miLista.setCommandListener(this);
}

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {
// TODO Auto-generated method stub
}

protected void pauseApp() {
// TODO Auto-generated method stub
}

protected void startApp() throws MIDletStateChangeException {
// TODO Auto-generated method stub
// Establecemos el "Display" actual a nuestra pantalla
display.setCurrent(miLista);
}

public void commandAction(Command c, Displayable s) {
// TODO Auto-generated method stub
if (c == this.miLista.SELECT_COMMAND){ // Si selecciono
this.MuestraMensaje();
}
if (c == salir){
try {
this.destroyApp(false);
notifyDestroyed();
} catch (MIDletStateChangeException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
if (c == acepta){
this.MuestraMensaje();
}
}

public void MuestraMensaje(){
miAlerta = new Alert("Opcion", miLista.getString(miLista.getSelectedIndex()), null, null);
display.setCurrent(miAlerta, miLista);
}
}