widgets
ATENCIÓN: Este tutorial todavía está en desarrollo, puede contener errores y partes incompletas.
ZUI es capaz, de procesar cualquier tipo de widget de Swing aunque es necesario crear un wrapper alrededor
para que funcione correctamente. Por ello existe esta lista de widgets implementados (en azul) y de no implementados (en rojo). Además, hay
pendiente un sistema que permita que los usuarios extiendan esta lista de wrappers.
índice
applet
Widget todavía no implementado.
button
atributos
nombre | descripción |
iconPath | path en donde se encuentra una imagen para mostrar en el botón |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
mnemonic | caracter mnemónico a marcar |
- | cualquier atributo definido en JButton de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget tiene algún cambio en su estado |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<button text="Aceptar" mnemonic="A" onAction="doAccept"/>
(subir)
checkbox
atributos
nombre | descripción |
alignment | alineación del cuadro de check respecto al texto. Los posibles valores son left, center y right siendo left el valor por defecto |
iconPath | path en donde se encuentra una imagen para mostrar en el botón |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
mnemonic | caracter mnemónico a marcar |
- | cualquier atributo definido en JCheckBox de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget tiene algún cambio en su estado |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<checkbox text="Incluido" mnemonic="I" onChange="doCheckBoxChanged"/>
(subir)
combobox
atributos
nombre | descripción |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
- | cualquier atributo definido en JComboBox de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget tiene algún cambio en su estado |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<combobox id="combo">
<item text="Text 1" value="1">
<item text="Text 2" value="2">
</combobox>
(subir)
dialog
Crea un Dialog, utilizado para crear ventanas secundarias a la principal. La clase ZDialog posee un constructor en el que se puede pasar
la ventana de la que depende para hacerla modal. Atención: este tag no existe como tal,
al ser un Frame se define mediante el elemento raíz <zui>
atributos
nombre | descripción |
centered | booleano que indica si se centra el diálogo en la pantalla |
height | alto del diálogo |
layoutContent | disposición de los widgets hijos |
width | ancho del diálogo |
- | cualquier atributo definido en JDialog de tipo String, int, long, double o boolean |
ejemplo
<dialog width="300" height="100" centered="true">
<label text="Texto">
</dialog>
(subir)
frame
Crea un Frame, utilizado normalmente como base para una aplicación. Atención: este tag no existe como tal,
al ser un Frame se define mediante el elemento raíz <zui>
atributos
nombre | descripción |
centered | booleano que indica si se centra el frame en la pantalla |
height | alto del frame |
layoutContent | disposición de los widgets hijos |
width | ancho del frame |
- | cualquier atributo definido en JFrame de tipo String, int, long, double o boolean |
ejemplo
<frame width="300" height="100" centered="true">
<label text="Texto">
</frame>
(subir)
include
Permite dividir el documento XML en varias partes más manejables. De esta forma se permite exista un documento
principal cuyo nombre coincida con el nombre de la clase que recibe los eventos y varios documentos secundarios
insertados en el principal mediante este tag.
atributos
nombre | descripción |
src | archivo del que hay que hacer la inclusión. |
ejemplo
<include src="sample_tab1.xml"/>
(subir)
item
Tag que permite insertar pares texto-valor dentro de combobox y de list
atributos
nombre | descripción |
id | identificador global dentro de la ventana en la que está incluido el widget |
text | texto a visualizar |
value | valor contenido |
ejemplo
<combobox id="combo">
<item text="Text 1" value="1">
<item text="Text 2" value="2">
</combobox>
<list id="combo">
<item text="Text 1" value="1">
<item text="Text 2" value="2">
</list>
(subir)
label
atributos
nombre | descripción |
alignment | alineación del texto. Los posibles valores son left, center y right siendo left el valor por defecto |
iconPath | path en donde se encuentra una imagen para mostrar en el botón |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
- | cualquier atributo definido en JLabel de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<label text="Etiqueta"/>
(subir)
list
atributos
nombre | descripción |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
- | cualquier atributo definido en JList de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onListSelection | evento lanzado cuando se selecciona un item |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<list onListSelection="doItemSelected">
<item text="Text 1" value="1"/>
<item text="Text 2" value="2"/>
</list>
(subir)
menu
Widget que crea un menú, sólo puede ser hijo de menubar o de otro menu.
atributos
nombre | descripción |
iconPath | path en donde se encuentra una imagen para mostrar en el botón |
id | identificador global dentro de la ventana en la que está incluido el widget |
- | cualquier atributo definido en JMenu de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget tiene algún cambio en su estado |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<menubar>
<menu text="Menu 1">
<menuitem text="Item 1" onAction="doItem1">
<menu text="Menu 3">
<menuitem text="Item 2" onAction="doItem2">
</menu>
</menu>
<menu text="Menu 2">
</menu>
</menubar>
(subir)
menubar
Crea una barra de menú pudiendo ser únicamente hijo directo de frame, dialog o
applet y su inclusión no ha de tenerse en cuenta a la hora de la distribución del layout.
atributos
nombre | descripción |
iconPath | path en donde se encuentra una imagen para mostrar en el botón |
id | identificador global dentro de la ventana en la que está incluido el widget |
- | cualquier atributo definido en JMenu de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget tiene algún cambio en su estado |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<menubar>
<menu text="Menu 1">
<menuitem text="Item 1" onAction="doItem1">
<menu text="Menu 3">
<menuitem text="Item 2" onAction="doItem2">
</menu>
</menu>
<menu text="Menu 2">
</menu>
</menubar>
(subir)
menuitem
Widget que crea un item de menú, sólo puede ser hijo de menu.
atributos
nombre | descripción |
iconPath | path en donde se encuentra una imagen para mostrar en el botón |
id | identificador global dentro de la ventana en la que está incluido el widget |
- | cualquier atributo definido en JMenu de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget tiene algún cambio en su estado |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<menubar>
<menu text="Menu 1">
<menuitem text="Item 1" onAction="doItem1">
<menu text="Menu 3">
<menuitem text="Item 2" onAction="doItem2">
</menu>
</menu>
<menu text="Menu 2">
</menu>
</menubar>
(subir)
menuseparator
Crea una separación entre menús y/o menuitems , sólo puede ser hijo de menu.
ejemplo
<menubar>
<menu text="Menu 1">
<menuitem text="Item 1" onAction="doItem1">
<menuseparator/>
<menuitem text="Item 2" onAction="doItem2">
</menu>
</menubar>
(subir)
panel
atributos
nombre | descripción |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
- | cualquier atributo definido en JComboBox de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget tiene algún cambio en su estado |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<combobox id="combo">
<item text="Text 1" value="1">
<item text="Text 2" value="2">
</combobox>
(subir)
passwordfield
atributos
nombre | descripción |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
- | cualquier atributo definido en JPasswordField de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onCaret | evento lanzado cuando el cursor se mueve dentro del campo de texto |
onChange | evento lanzado cuando el widget cambia el contenido y después pierde el foco |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<passwordfield text="Etiqueta"/>
(subir)
popupmenu
Widget todavía no implementado.
progressbar
atributos
nombre | descripción |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
- | cualquier atributo definido en JPasswordField de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onChange | evento lanzado cuando el widget cambia el contenido y después pierde el foco |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
(subir)
radiobutton
atributos
nombre | descripción |
alignment | alineación del cuadro de check respecto al texto. Los posibles valores son left, center y right siendo left el valor por defecto |
group | nombre del grupo al que pertenece el radiobutton para hacerlos excluyentes mutuamente |
iconPath | path en donde se encuentra una imagen para mostrar en el botón |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
mnemonic | caracter mnemónico a marcar |
- | cualquier atributo definido en JPasswordField de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onChange | evento lanzado cuando el widget cambia el contenido y después pierde el foco |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
(subir)
scrollpane
separator
slider
spinner
splitpane
Widget todavía no implementado.
tab
tabbedpane
table
table - head
table - row
table - col
textarea
textfield
atributos
nombre | descripción |
id | identificador global dentro de la ventana en la que está incluido el widget |
layout | propiedades de la disposición del widget dentro del contenedor en que está ubicado |
- | cualquier atributo definido en JTextField de tipo String, int, long, double o boolean |
listeners
evento | descripción |
onAction | evento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar |
onCaret | evento lanzado cuando el cursor se mueve dentro del campo de texto |
onChange | evento lanzado cuando el widget cambia el contenido y después pierde el foco |
onFocus | evento lanzado cuando el widget recibe o pierde el foco |
onItem | evento lanzado cuando el widget recibe selección |
onKey | evento lanzado cuando el widget recibe una pulsación de teclado |
onMouse | evento lanzado por el ratón al widget |
ejemplo
<textfield text="Etiqueta"/>
(subir)
togglebuton
tree
Widget todavía no implementado.