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
• button
• checkbox
• combobox
• dialog
• frame
• include
• item
• label
• list
• menu
• menubar
• menuitem
• menuseparator
• panel
• passwordfield
• popupmenu
• progressbar
• radiobutton
• scrollpane
• separator
• slider
• spinner
• splitpane
• tab
• tabbedpane
• table
• table - head
• table - row
• table - col
• textarea
• textfield
• togglebuton
• tree

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.