ZUI - Swing made easy

SourceForge.net Logo

Newsfeed Lesser GPL License Valid XHTML 1.0! Valid CSS!

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

nombredescripción
iconPathpath en donde se encuentra una imagen para mostrar en el botón
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades de la disposición del widget dentro del contenedor en que está ubicado
mnemoniccaracter mnemónico a marcar
-cualquier atributo definido en JButton de tipo String, int, long, double o boolean

listeners

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget tiene algún cambio en su estado
onFocusevento lanzado cuando el widget recibe o pierde el foco
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento lanzado por el ratón al widget

ejemplo

<button text="Aceptar" mnemonic="A" onAction="doAccept"/>

(subir)

checkbox

atributos

nombredescripción
alignmentalineación del cuadro de check respecto al texto. Los posibles valores son left, center y right siendo left el valor por defecto
iconPathpath en donde se encuentra una imagen para mostrar en el botón
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades de la disposición del widget dentro del contenedor en que está ubicado
mnemoniccaracter mnemónico a marcar
-cualquier atributo definido en JCheckBox de tipo String, int, long, double o boolean

listeners

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget tiene algún cambio en su estado
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento lanzado por el ratón al widget

ejemplo

<checkbox text="Incluido" mnemonic="I" onChange="doCheckBoxChanged"/>

(subir)

combobox

atributos

nombredescripción
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades 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

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget tiene algún cambio en su estado
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento 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

nombredescripción
centeredbooleano que indica si se centra el diálogo en la pantalla
heightalto del diálogo
layoutContentdisposición de los widgets hijos
widthancho 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

nombredescripción
centeredbooleano que indica si se centra el frame en la pantalla
heightalto del frame
layoutContentdisposición de los widgets hijos
widthancho 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

nombredescripción
srcarchivo 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

nombredescripción
ididentificador global dentro de la ventana en la que está incluido el widget
texttexto a visualizar
valuevalor 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

nombredescripción
alignmentalineación del texto. Los posibles valores son left, center y right siendo left el valor por defecto
iconPathpath en donde se encuentra una imagen para mostrar en el botón
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades 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

eventodescripción
onFocusevento lanzado cuando el widget recibe o pierde el foco
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento lanzado por el ratón al widget

ejemplo

<label text="Etiqueta"/>

(subir)

list

atributos

nombredescripción
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades 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

eventodescripción
onFocusevento lanzado cuando el widget recibe o pierde el foco
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onListSelectionevento lanzado cuando se selecciona un item
onMouseevento 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

nombredescripción
iconPathpath en donde se encuentra una imagen para mostrar en el botón
ididentificador 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

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget tiene algún cambio en su estado
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento 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

nombredescripción
iconPathpath en donde se encuentra una imagen para mostrar en el botón
ididentificador 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

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget tiene algún cambio en su estado
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento 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

nombredescripción
iconPathpath en donde se encuentra una imagen para mostrar en el botón
ididentificador 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

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget tiene algún cambio en su estado
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento 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

nombredescripción
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades 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

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget tiene algún cambio en su estado
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento 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

nombredescripción
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades 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

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onCaretevento lanzado cuando el cursor se mueve dentro del campo de texto
onChangeevento lanzado cuando el widget cambia el contenido y después pierde el foco
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento lanzado por el ratón al widget

ejemplo

<passwordfield text="Etiqueta"/>

(subir)

popupmenu

Widget todavía no implementado.

progressbar

atributos

nombredescripción
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades 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

eventodescripción
onChangeevento lanzado cuando el widget cambia el contenido y después pierde el foco
onFocusevento lanzado cuando el widget recibe o pierde el foco
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento lanzado por el ratón al widget
(subir)

radiobutton

atributos

nombredescripción
alignmentalineación del cuadro de check respecto al texto. Los posibles valores son left, center y right siendo left el valor por defecto
groupnombre del grupo al que pertenece el radiobutton para hacerlos excluyentes mutuamente
iconPathpath en donde se encuentra una imagen para mostrar en el botón
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades de la disposición del widget dentro del contenedor en que está ubicado
mnemoniccaracter mnemónico a marcar
-cualquier atributo definido en JPasswordField de tipo String, int, long, double o boolean

listeners

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onChangeevento lanzado cuando el widget cambia el contenido y después pierde el foco
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento 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

nombredescripción
ididentificador global dentro de la ventana en la que está incluido el widget
layoutpropiedades 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

eventodescripción
onActionevento lanzado cuando el widget recibe una pulsación de teclado o click de ratón indicando ejecutar
onCaretevento lanzado cuando el cursor se mueve dentro del campo de texto
onChangeevento lanzado cuando el widget cambia el contenido y después pierde el foco
onFocusevento lanzado cuando el widget recibe o pierde el foco
onItemevento lanzado cuando el widget recibe selección
onKeyevento lanzado cuando el widget recibe una pulsación de teclado
onMouseevento lanzado por el ratón al widget

ejemplo

<textfield text="Etiqueta"/>

(subir)

togglebuton

tree

Widget todavía no implementado.