Floating Containers

This section provides a brief description of the floating containers available for developing a Nexaweb Java application UI.

In addition to this floating container, see also Containers and Panes and Root Elements.

window

A floating container that resides within a rootPane or desktopPane.

Nexaweb Studio makes this widget available in the Palette view from which you can drag and drop it onto a UI file in the Visual Editor.

Example XAL for using this widget in a freePane:

<window height="300px" title="New Window" width="300px" borderPosition="north"/>

The following table lists and provides brief descriptions of window component specific attributes:

Attribute	Description
centered	Specifies a window appears in middle of the parent container regardless of size and location settings. Usage: centered="true"
closable	Specifies that a close button appears at the top-right corner of the window. Usage: closable="true"
closeImage	Specifies the URL of the icon that represents that this window is closed.
iconImage	Specifies the URL of the frame icon to display in the top-left corner of the window.
maximizable	Specifies that a maximize button appears at the top-right corner of the window. Appears by default. For window to not display a maximize button, set this attribute to false.
maximized	Specifies that the window displays maximized to take up entire space of pane. Usage: maximized="true"
maximizeImage	Specifies the URL of the icon to use to maximize this window.
minimizable	Specifies that a minimize button appears at the top-right corner of the window. Appears by default. For window to not display a minimize button, set this attribute to false.
resizable	Specifies that a user can resize this window by dragging its border. Default behavior. To prevent window from being sizeable, set this attribute to false.
restoreImage	Specifies the URL of the icon to display in the maximize\minimize box to represent when this window is maximized or minimized.
showTitleBar	Specifies whether this window displays a title bar. true=yes; false=no. True by default.
title	Specifies the text to display in the title bar. Set to: New Window by default.
titleBackgroundColor	Specifies the back ground color to use for the title bar.
titleColor	Specifies the color of the text in the title bar.

dialog

A floating container that resides within a rootPane or desktopPane.

In addition, a dialog:
- Is not maximizable or minimizable, by default
- Can be modal; that is, does not release the input focus while it is open.

Nexaweb Studio makes this widget available in the Palette view from which you can drag and drop it onto a UI file in the Visual Editor.

Example XAL for using this widget in a freePane:

<dialog height="300px" title="New Dialog" width="300px" borderPosition="north"/>

The following table lists and provides brief descriptions of dialog component specific attributes:

Attribute	Description
modal	Specifies that the dialog is modal. A modal dialog prevents the user from taking any keyboard or mouse actions outside of the modal dialog until that dialog is closed. Note: You must set this attribute on the component intially; you cannot set it on the fly.

messageDialog

A floating container that resides within a rootPane or desktopPane.

In addition, is a special type of dialog that displays a message, a matching icon and some buttons. Includes a single OK button, by default. However, you can add new buttons and replace the default OK button.

Nexaweb Studio makes this widget available in the Palette view from which you can drag and drop it onto a UI file in the Visual Editor.

Example XAL for using this widget in a freePane:

<messageDialog height="300px" title="New Message Dialog" width="300px" borderPosition="north"/>

The following table lists and provides brief descriptions of messageDialog component specific attributes:

Attribute	Description
message	Specifies the message text of the dialog.
type	Specifies the icon to appear beside the message in the dialog. Values: question, error, info, warning, plain. Plain by default. Note: You must set this attribute on the component initially; you cannot set it after the component displays.