Element: Dialog.

Icon:

Text: A dialog window.

Description: A Dialog is a container element that displays in an independent window.  Dialog windows can be closed, but not minimized. Differently to frames, closing a dialog has no consequences.

Dialogs have the peculiarity that they display always on top of the frame that precedes them in the tree of elements of the view. That is, that frame can never hide the dialog.

Table of properties

Name Description Values accepted
Main
Títle The text displayed as title for this window. Any constant or variable of type String.
Layout The policy for laying out the children of this container. An Object variable of the class java.awt.Layout or one of the following constants: border, flow, grid, hbox, vbox.
  • flow requires an additional parameter, that indicates the alignment of its children. It must be one of the constants: left, center or right.
  • grid requires two additional integer parameters, indicating the number of rows and columns of the grid, respectively.

All the options accept two optional integer parameters that indicate the horizontal and vertical separation between children. For instance, border:10,5.

Visible The visibility of the element. A boolean variable or one of the constants true or false.
Location and Size
Location The location of the window on the computer screen, in pixels An Object variable of the class java.awt.Point or the integer values for the X and Y positions, respectively, separated by a comma. The special value center places the window in the center of the screen.
Size The size of the element. An Object variable of the class java.awt.Dimension or the integer values for the width and the height, respectively, separated by a comma. The special value pack adjusts the size to the minimum required by the children of the element.
Resizable Whether the user can resize the window. A boolean variable or one of the constants true or false.
Graphical Aspect
Background The color used for the background of the element and that of its children (unless they explicitely set their own value for this property). An Object variable of the class java.awt.Color or one of the predefined colors: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, white, yellow.

A color can also be specified providing its integer RGB coordinates (between 0 and 255), plus an optional transparency coordinate.

The default value is decided by the system.

Foreground The color used for any text displayed by the element or by its children (unless they explicitely set their own value for this property). See the values for the Background property.
Font The font used for any text displayed by the element or by its children (unless they explicitely set their own value for this property). An Object variable of the class java.awt.Font or a set of family, style and size, separated by commas. The style must be one of  plain, bold, italic, bold | italic. Example: Monospaced,italic,18.

The default value is decided by the system.

Tooltip The text displayed when the cursor lingers on top of the element. Any constant or variable of type String.