En el tema anterior comentamos que la Form es un elemento visual que
permite agregar otros elementos dentro de ella. Esto es muy útil ya que si necesitamos
que el usuario proporcione una serie de datos diferentes, como nombre, edad y
fecha de nacimiento, lo podemos hacer agregando elementos diferentes a una
Form. Los elementos que podemos agregar dentro de una Form son 6: StringItem,
ImageItem, TextField, DateField, ChoiceGroup y Gauge. De ningún modo es posible
añadir un Alert, List o TextBox dentro de una Form.
Veamos uno por uno, destacando la manera de definirlos y un ejemplo.
Veamos uno por uno, destacando la manera de definirlos y un ejemplo.
STRINGITEM
Muestra una etiqueta de texto dentro de la Form. Veamos cómo se define y
un ejemplo.
StringItem strItem = new StringItem(String
título, String texto);
|
Form form = new Form (“Interfaz Alto
Nivel II”);
StringItem strItem = new StringItem(“Saludo”,
“¿Hola, cómo estás?”);
form.append(strItem);
|
El StringItem solo tiene dos parámetros que debemos proporcionar y ambos
son de tipo String, por lo tanto deben ir entre comillas (“”). En el ejemplo
vemos cómo definimos un StringItem y vemos que también hemos definido una Form,
porque los 6 elementos que vamos a ver tienen que ser siempre agregados dentro
de una Form, ya que por sí solos no son útiles. Utilizamos el método .append(Item
item); para agregar nuestro Item a la Form, en este caso un StringItem.
No comentaremos detalles particulares de estos 6 elementos ya que a
medida que los vayas usando te irás familiarizando con cada uno de ellos.
Descargar la aplicación de ejemplo. Descargar App
Descargar el código de la aplicación (Idioma Español) y los recursos
utilizados. Descargar
Para ver los errores que pueden con el uso de este elemento visual haz
clic aquí (Idioma Español).
IMAGEITEM
Nos permite mostrar una imagen dentro de una Form. Veamos cómo se define
y un ejemplo.
ImageItem imgItem = new ImageItem(String
título, Image imagen, int layout, String texto_alternativo);
|
try{
Form
form = new Form (“Interfaz Alto Nivel II”);
Image foto = Image.createImage(“/ubicación.extensión”);
ImageItem imgItem = new ImageItem(“Mi Foto”, foto, ImageItem.LAYOUT_CENTER,
“mi cara”);
form.append(imgItem);
}catch(IOException io){}
|
El layout corresponde a la situación del ImageItem dentro de la Form
(alineación vertical y horizontal), y puede ser: LAYOUT_DEFAULT (sin alineación
específica), LAYOUT_LEFT (alineado a la izquierda horizontalmente),
LAYOUT_RIGHT alineado a la derecha horizontalmente, LAYOUT_CENTER (centrado
horizontalmente), LAYOUT_NEWLINE_BEFORE (el ítem será colocado al inicio de una
nueva fila), LAYOUT_NEWLINE_AFTER (el ítem será el ultimo de la fila y el
próximo ítem dentro de la Form, si hay alguno, se colocará en una nueva fila). El
texto alternativo es un texto que aparece en el lugar de la imagen en el caso
de que la imagen no se pueda mostrar. Como vemos, es necesario definir la
imagen que se usará en el ImageItem, entonces encerramos todo en un try/catch
porque cuando se define una imagen ocurre un error de tipo IOException.
Descargar la aplicación de ejemplo. Descargar App
Descargar el código de la aplicación (Idioma Español) y los recursos
utilizados. Descargar
Para ver los errores que pueden con el uso de este elemento visual haz
clic aquí (Idioma Español).
TEXTFIELD
Nos permite mostrar un campo de texto pequeño donde podemos escribir
dentro de una Form. Es como un TextBox pero pequeño. Veamos cómo se define y un
ejemplo.
TextField tf = new TextField(String
título, String texto, int max, int limitación);
|
Form form = new Form (“Interfaz Alto
Nivel II”);
TextField tf = new TextField(“Nombre”, “”,
20, TextField.ANY);
form.append(tf);
|
Este elemento es muy similar a TextBox en su definición y en los
parámetros que necesita. Así, podemos utilizar las mismas limitaciones que usa TextBox:
ANY, NUMERIC, PASSWORD, PHONENUMBER, EMAILADDR, URL. Y es importante destacar
que TextBox utiliza la limitación que le proporciona TextField, ya que cuando
definimos un TextBox la limitación la colocamos como TextField (TextBox tb =
new TextBox(“Título”, “texto”, 15, TextField.ANY);). Debemos siempre
recordar añadir el elemento a la Form a través del método .append(Item item).
Descargar la aplicación de ejemplo. Descargar App
Descargar el código de la aplicación (Idioma Español) y los recursos
utilizados. Descargar
Para ver los errores que pueden con el uso de este elemento visual haz
clic aquí (Idioma Español).
DATEFIELD
Nos permite introducir horas y fechas dentro de una Form. Veamos cómo se
define y un ejemplo.
DateField df = new DateField(String
título, int modo);
|
Form form = new Form (“Interfaz Alto Nivel
II”);
DateField df = new DateField(“Hora”,
DateField.TIME);
form.append(df);
|
Aquí lo importantes es que modo puede ser: DATE (para fechas), TIME (para
horas) o DATE_TIME (para fecha y hora, simultáneamente). Podemos agregar un
DateField a una Form para que el usuario introduzca su fecha de nacimiento, por
mencionar un ejemplo, y podemos después saber qué fecha colocó a través del
método .getDate(); y utilizar esta fecha en otra parte
de la aplicación.
Descargar la aplicación de ejemplo. Descargar App
Descargar el código de la aplicación (Idioma Español) y los recursos
utilizados. Descargar
Para ver los errores que pueden con el uso de este elemento visual haz
clic aquí (Idioma Español).
CHOICEGROUP
Nos permite crear listas dentro de una Form. Es similar a List pero no
ocupa toda la pantalla sino que se distribuye dentro de una Form. Veamos cómo
se define y un ejemplo.
ChoiceGroup cg = new ChoiceGroup(String título,
int tipo, String[] elementos, Image[] imágenes);
|
Form form = new Form (“Interfaz Alto
Nivel II”);
String[] elems = {“A”, “B”, “C”};
ChoiceGroup cg = new
ChoiceGroup(“Opciones”, ChoiceGroup.EXCLUSIVE, elems, null);
form.append(cg);
|
Al igual que List, para definir un ChoiceGroup primero hay que definir un
array de tipo String con los elementos que queremos que se muestren en el
ChoiceGroup.
Una particularidad que hay que destacar y que debemos tomar en cuenta es
que los tipos de lista permitidos por ChoiceGroup son: EXCLUSIVE, MULTIPLE,
POPUP; no acepta el tipo IMPLICIT, que es exclusivo de List, ni List soporta el
tipo POPUP, que es exclusivo de ChoiceGroup. Hay que tomar en cuenta la misma
advertencia que para List en cuanto al número de elementos en el array de tipo
String y el de tipo Image.
Descargar la aplicación de ejemplo. Descargar App
Descargar el código de la aplicación (Idioma Español) y los recursos
utilizados. Descargar
Para ver los errores que pueden con el uso de este elemento visual haz
clic aquí (Idioma Español).
GAUGE
Nos permite mostrar una barra de progreso o de estado, útil para representar
un porcentaje a través de una barra, por mencionar un ejemplo. Veamos cómo se
define y un ejemplo.
Gauge gaug = new Gauge(String título, boolean
interactivo, int valor_max, int valor_ini);
|
Form form = new Form (“Interfaz Alto
Nivel II”);
Gauge gaug = new Gauge(“Volumen”, true,
10, 3);
form.append(gaug);
|
En este elemento tenemos una variable de tipo boolean llamada interactivo
que puede tomar el valor de true o false solamente, y significa que el
usuario podrá cambiar el valor del Gauge a través del teclado o la pantalla de
su celular (true) o no podrá hacerlo (false). El parámetro valor_max
corresponde al valor máximo de la barra Gauge, y valor_ini, al valor inicial.
Por último, no debemos olvidar agregar el elemento creado a la Form.
Descargar la aplicación de ejemplo. Descargar App
Descargar el código de la aplicación (Idioma Español) y los recursos
utilizados. Descargar
Para ver los errores que pueden con el uso de este elemento visual haz clic
aquí (Idioma Español).
No hay comentarios.:
Publicar un comentario