|
|
Antes de presentar las definición de
las clases de controles que ofrece el AWT es necesario conocer
la jerarquía de clases que existen en esta librería,
pues todos los controles (clases que representan controles) han
heredado muchos métodos y propiedades de clases genéricas
y comunes a todos los elementos gráficos de la pantalla.
Representa a un elemento (componente) gráfico
en la pantalla, en sí esta clase sólo presenta una
especie de interfaz común para todos los elementos gráficos,
teniendo como principales métodos:
| void disable() | Desactiva una componente. |
| void enable() | Habilita o activa una componente. |
| Font getFont () | Retorna el Font actual de la componente. |
| Graphics getGraphics() | Retorna una instancia de Graphics que permite dibujar en el componente |
| void show() | Visualiza la componente. |
| void hide() | Oculta la componente. |
| void resize(int dx, int dy) | Establece las dimensiones de la componente. |
Una vez conocida la clase Component procedamos
a estudiar las clases que representan elementos gráficos.
Al crear una instancia de ésta clase
se tiene un control que representa un botón pulsador. Esta
clase tiene dos constructores :
| Button( ) | el control no tiene etiqueta. |
| Button( String etiqueta ) | etiqueta establece el nombre del control |
Los métodos más usados de ésta
clase son:
| void setLabel( String etiqueta ) | establece la etiqueta del botón. |
| String getLabel() | retorna la etiqueta del botón. |
Al crear una instancia de esta clase se tiene
un control que representa un recuadro de selección, la
cual puede tener uno de dos estados: seleccionado (true) y deseleccionado
(false); esta clase tiene tres constructores, los más usados
son dos :
| Checkbox() | sin etiqueta. |
| Checkbox(String etiqueta ) | etiqueta establece el nombre del control. |
El tercer constructor lo veremos cuando trabajemos
con radio botones.
Los métodos que se usan con mayor frecuencia
son:
| void setLabel( String etiqueta ) | establece la etiqueta del botón. |
| String getLabel() | retorna la etiqueta del botón. |
| boolean getState() | retorna true si está activado. |
| void setState( boolean estado ) | establece el estado del botón. |
Un radio botón siempre se encuentra
en grupos y su funcionamiento es igual al de un Checkbox con la
diferencia que sólo uno de los radio botones del grupo
puede tener un estado TRUE (seleccionado), otra diferencia es
la forma como se visualizan en la pantalla mientras que un Checkbox
dibuja un recuadro, el RadioButton dibuja un círculo. Antes
de ver como se crea un RadioButton es necesario aprender como
se crea un grupo de RadioButtons:
Esta clase representa un grupo de Checkboxes
que al estar contenidos en el grupo cambian de apariencia y funcionamiento,
adoptando la apariencia y funcionalidad de un RadioButton (control
que en Java no tiene una clase que lo represente en forma directa
). Su constructor no tiene parámetros.
Los métodos mas usados son:
| void setCurrent( Checkbox chk ) | establece el control seleccionado. |
| Checkbox getCurrent() | retorna el control seleccionado. |
Ahora que conocemos la clase CheckboxGroup
podemos aprender como crear RadioButtons, como se ha dicho anteriormente
un RadioButton en el AWT es un Checkbox que pertenece a un grupo,
entonces para crear un RadioButton sólo es necesario crear
una instancia de Checkbox pero usando un constructor especial:
Checkbox( String etiqueta, CheckBoxGroup grupo,
boolean estado )
El primer parámetro indica el nombre
(etiqueta) del control, el segundo parámetro indica el
grupo de controles (CheckboxGroup) al que va ha pertenecer el
RadioButton y el último parámetro indica el estado
de selección del control.
Barras
de desplazamiento : La clase Scrollbar
Esta clase representa una barra de desplazamiento,
sus constructores son:
| Scrollbar ( int orientación ) | Donde orientación puede tomar dos valores Scrollbar.HORIZONTAL, Scrollbar.VERTICAL |
| Scrollbar ( int orientacion, int value, int visible, int min, int max ) | Donde :
|
Los métodos que se usan con mayor frecuencia
en un objeto del tipo Scrollbar son:
| int getLineIncrement() | Retorna el incremento mínimo del scrollbar. |
| int getMaximum() | Retorna el valor máximo que puede tomar el control. |
| int getMinimum() | Retorna el valor mínimo que puede tomar el control. |
| int getOrientation() | Retorna la orientación. |
| int getPageIncrement() | Retorna el incremento máximo del scrollbar. |
| int getValue() | Retorna el valor actual del scrollbar. |
| Void setValue( int valor ) | Establece el valor actual del scrollbar. |
| Void setLineIncrement( int valor ) | Establece el incremento mínimo. |
| Void setPageIncrement( int valor ) | Establece el incremento máximo. |
| Void setValues( int val, int vis, int min, int max ) | Establece el valor actual, las dimensiones del área de arrastre y el rango de valores que puede tomar el scrollbar. |
Esta clase representa a un control de edición
de texto, sólo permite editar una línea de texto,
sus constructores son:
| TextField() | Inicializa el control. |
| TextField(int n ) | Crea un control con n columnas |
| TextField(String texto ) | Crea un control con un texto inicial |
| TextField(String texto, int n) | Crea un control con un texto inicial y n columnas. |
Los métodos mas usados en esta clase
son :
| String getSelectedText( ) | Retorna un String que representa el texto que ha sido seleccionado dentro de una caja de edición de texto. |
| void select( int inicio, int fin ) | Establece el rango de caracteres de la caja de edición que se desea que estén seleccionados. |
| void selectAll( ) | Selecciona todos los elementos de la caja de texto. |
| int getSelectionStart ( ) | Retorna el índice o posición del primer carácter seleccionado en la caja de edición. |
| int getSelecionEnd( ) | Retorna el índice o posición del último carácter seleccionado en la caja de edición. |
| void setEditable( boolean estado) | Establece si se puede o no editar el contenido de la caja de texto. |
| boolean getEditable ( ) | Retorna un valor booleano indicando si se puede editar o no el contenido de una caja de texto. |
| void setEchoCharacter( char c ) | Establece el caracter que se debe de visualizar en la caja de edición, esta función es útil para cajas de edición que trabajan con passwords. |
| boolean echoCharacterIsSet() | Retorna true si el control esta en modo password. |
| char getEchoCharacter() | Retorna el caracter que se visualiza en un control que está en el modo password. |
| String getText() | Retorna el contenido del control |
| void setText( String txt ) | Establece el contenido del control |
Esta clase representa a un control que contiene una lista de opciones seleccionables, se pueden usar cualquiera de los siguientes controles:
| List( ) | Crea un listbox sin renglones visibles y de simple selección, es decir que sólo una opción puede estar seleccionada. |
| List(int n, boolean mult) | Crea un listbox con n renglones visibles y si el parámetro mult es true se pueden tener varias opciones seleccionadas a la vez. |
Los métodos que se usan con mayor frecuencia
son:
| void addItem ( String opcion ) | Agrega una opción al final de la lista de opciones. |
| int countItems( ) | Retorna el número de opciones. |
| void clear( ) | Borra todas las opciones del listbox. |
| Boolean allosMultipleSelections( ) | Retorna true si se pueden seleccionar múltiples opciones. |
| void delItem( int n ) | Borra la n-ésima -1 opción del listbox. |
| void delItems( int inicio, int fin ) | Borra un rango de opciones. |
| void deselect( int n ) | Deselecciona la opción de la posición n. |
| String getItem( int n ) | Retorna la n-ésima -1 opción. |
| int getRows( ) | Retorna el número de opciones que se pueden ver. |
| int getSelectedIndex( ) | Retorna el orden o índice de la opción seleccionada. En caso que no haya una selección o existan mas de una opción seleccionadas retorna -1. |
| String getSelectedItem( ) | Retorna la opción seleccionada. En caso de no haber ninguna opción seleccionada o si hay varias opciones seleccionadas retorna null. |
| int[ ] getSelectedIndexs( ) | Retorna el orden o índice de las opciones seleccionadas. En caso que no haya una selección retorna null. |
| String [ ] getSelectedItems( ) | Retorna las opciones seleccionadas. En caso de no haber ninguna opción seleccionada retorna null. |
| boolean isSelected( int n ) | Retorna true si la n-ésima -1 opción esta seleccionada, de lo contrario retorna false. |
| void replaceItem( int n, String opc ) | Reemplaza la n-ésima -1 opción por una nueva. |
| void select( int n ) | Selecciona la n-ésima -1 opción. |
| void setMultipleSelections(boolean multiple) | Establece si se puede o no seleccionar múltiples opciones. |
Los índices de las opciones empiezan
en el cero, es decir la primera opción está en la
posición 0, la segunda en la posición 1 y la n-ésima
está en la n-1.
Esta clase representa a un control que contiene
múltiples opciones, las cuales se muestran en una lista
desplegable, este control sólo visualiza la opción
seleccionada, para cambiar de selección es necesario desplegar
la lista de opciones presionando en el botón correspondiente.
A diferencia que un ListBox este control sólo permite la
selección de una opción a la vez.
El único constructor de esta clase no
tiene parámetros.
Los métodos de esta clase son:
| void addItem( String opcion ) | Agrega una opción a la lista. |
| int countItems( ) | Retorna el número de opciones. |
| String getItem( int n ) | Retorna la n-ésimo -1 opción. |
| int getSelectedIdex( ) | Retorna la posición en la lista de la opción seleccionada actualmente. |
| String getSelectedItem( ) | Retorna la opción seleccionada actualmente. |
| void select( int n ) | Selecciona la n-ésima -1 opción. |
| void select( String nombre ) | Selecciona la opción con un nombre dado. |
Los índices de las opciones empiezan
en el cero, es decir la primera opción está en la
posición 0, la segunda en la posición 1 y la n-ésima
está en la n-1.
Esta clase representa un control que visualiza
una cadena de texto en una ventana, se puede usar cualquiera de
los siguientes constructores:
| Label( ) | Inicializa el control sin texto. |
| Label( String texto ) | Asigna un texto a la etiqueta |
| Label( String texto, int justifica ) | Asigna un texto y una justificación del texto |
Los métodos que se usan con mayor frecuencia
son :
| void setAlignment( int justifica ) | Establece la justificación del texto, los posibles valores que puede tomar son Label.CENTER, Label.RIGHT, Label.LEFT |
| int getAlignment() | Retorna la justificación actual del control. |
| void setText( String texto ) | Establece el texto del control. |
| String getText() | Retorna el texto del control. |