jsx3.gui.DialogAPI


Object
Object TypeThe JSX foundation class that this object is an instance of.
IDThe unique, system-assigned ID for this object.
NameSets the name assigned by the developer to identify this object.
Positioning
LeftSets the distance from left edge of container in pixels.
TopSets the distance from top edge of container in pixels.
WidthSets width of this dialog in pixels.
HeightSets height of this dialog in pixels.
Resize
ResizableDetermines if the dialog can be resized by the user at runtime.
Min WidthSets the minimum width of the dialog when resized.
Min HeightSets the minimum height of the dialog when resized.
Max WidthSets the maximum width of the dialog when resized.
Max HeightSets the maximum height of the dialog when resized.
Dialog
ModalSets whether this Dialog is modal.
StateSets the window state to full-sized (Maximized) or window-shaded (Minimized).
Z MultiplierSets the number to multiply the z-index for this dialog to give it precedence (dialogs index in the 5000 range).
Box
BG ColorSets the background color.
BackgroundSets the CSS background definition, such as background-image:url(abc.gif);background-repeat:repeat-x;.
Text AlignSets the alignment of any contained object or text.
OverflowSets the CSS overflow for this object, which defines how its on-screen view behaves when the contents are larger than the specified width and/or height.
CSS
CSS OverrideConvenience method for extending this object.
DisplaySets the CSS display property.
VisibilitySets the CSS visibility property.
Metadata
Load TypeSets the load type of this DOM branch.
AnnotationThe annotation comment visible in the Component Hierarchy palette.
Help IDA unique ID for use with context-sensitive help.

Object Type

Read-Only. The JSX foundation class that this object is an instance of.

ID

Read-Only. The unique, system-assigned ID for this object.
Getter: getId()

Name

Sets the name assigned by the developer to identify this object.
Getter: getName()
Setter: setName()
Property: jsxname

Left

Sets the distance from left edge of container in pixels. The unit (px) is implied and should not be entered.
Default Value: Centered in the parent container
Getter: getLeft()
Setter: setLeft()
Property: jsxleft

Top

Sets the distance from top edge of container in pixels. The unit (px) is implied and should not be entered.
Default Value: Centered in the parent container
Getter: getTop()
Setter: setTop()
Property: jsxtop

Width

Sets width of this dialog in pixels. The unit (px) is implied and should not be entered.
Default Value: No default, must specify
Getter: getWidth()
Setter: setWidth()
Property: jsxwidth

Height

Sets height of this dialog in pixels. The unit (px) is implied and should not be entered.
Default Value: No default, must specify
Getter: getHeight()
Setter: setHeight()
Property: jsxheight

Resizable

Determines if the dialog can be resized by the user at runtime.
Default Value: Resizable (jsx3.Boolean.TRUE)
Getter: getResizable()
Setter: setResizable()
Property: jsxresize
Allowed Values:

Min Width

Sets the minimum width of the dialog when resized. Units are implied pixels and only positive integers are allowed.
Setter: setResizeParameters()
Property: jsxminx

Min Height

Sets the minimum height of the dialog when resized. Units are implied pixels and only positive integers are allowed.
Setter: setResizeParameters()
Property: jsxminy

Max Width

Sets the maximum width of the dialog when resized. Units are implied pixels and only positive integers are allowed.
Setter: setResizeParameters()
Property: jsxmaxx

Max Height

Sets the maximum height of the dialog when resized. Units are implied pixels and only positive integers are allowed.
Setter: setResizeParameters()
Property: jsxmaxy

Modal

Sets whether this Dialog is modal. Modal dialogs mask the rest of the container with a semi-transparent mask that blocks mouse interaction. Modal dialogs do not show up in the taskbar.
Default Value: None (jsx3.gui.Dialog.NONMODAL)
Getter: getModal()
Setter: setModal()
Property: jsxmodal
Allowed Values:

State

Sets the window state to full-sized (Maximized) or window-shaded (Minimized).
Default Value: Maximized (jsx3.gui.Dialog.MAXIMIZED)
Getter: getWindowState()
Setter: setWindowState()
Property: jsxwindowstate
Allowed Values:

Z Multiplier

Sets the number to multiply the z-index for this dialog to give it precedence (dialogs index in the 5000 range). If a dialog needs to always be on top of other dialog instances, this multiplier can be increased to assure the appropriate z-index. For example, a value of 5 would stack this dialog on top of all dialogs with an alwaysOnTop multiplier less than 5.
Default Value: 1
Getter: getZMultiplier()
Setter: setZMultiplier()
Property: jsxzmultiplier

BG Color

Sets the background color. Accepts CSS values, such as predefined color names, RGB, or hexadecimal values. For example, red, rgb(255,0,0), or #ff0000.
Default Value: The default background color specified in the static field, DEFAULTBACKGROUNDCOLOR, of the component class. For example, the default background color for a list is #f3f2f4 and is specified in jsx3.gui.List.DEFAULTBACKGROUNDCOLOR. See the API documentation for the component. For some components, this property is empty.
Getter: getBackgroundColor()
Setter: setBackgroundColor()
Property: jsxbgcolor

Background

Sets the CSS background definition, such as background-image:url(abc.gif);background-repeat:repeat-x;.
Default Value: Empty
Getter: getBackground()
Setter: setBackground()
Property: jsxbg

Text Align

Sets the alignment of any contained object or text.
Default Value: Left (jsx3.gui.Block.ALIGNLEFT)
Getter: <code>getTextAlign</code>()
Setter: setTextAlign()
Property: jsxtextalign
Allowed Values:

Overflow

Sets the CSS overflow for this object, which defines how its on-screen view behaves when the contents are larger than the specified width and/or height.
Default Value: Expand (jsx3.gui.Block.OVERFLOWEXPAND)
Getter: getOverflow()
Setter: setOverflow()
Property: jsxoverflow
Allowed Values:

CSS Override

Convenience method for extending this object. CSS properties affecting layout, including border-width, padding, margin, width, and height are strongly discouraged, as they may interfere with the framework's internal box models. Since some controls are composited from multiple HTML elements, some styles may not cascade to nested elements.

Instance Properties are the preferred method for applying styles.
Getter: getCSSOverride()
Setter: setCSSOverride()
Property: jsxstyleoverride

Display

Sets the CSS display property. When set to None, content is hidden AND the container collapses.
Default Value: Block (jsx3.gui.Block.DISPLAYBLOCK)
Getter: getDisplay()
Setter: setDisplay()
Property: jsxdisplay
Allowed Values:

Visibility

Sets the CSS visibility property. When set to Hidden, content is hidden.
Default Value: Visible (jsx3.gui.Block.VISIBILITYVISIBLE)
Getter: getVisibility()
Setter: setVisibility()
Property: jsxvisibility
Allowed Values:

Load Type

Sets the load type of this DOM branch.
Default Value: Normal (jsx3.app.Model.LT_NORMAL)
Getter: getLoadType()
Setter: setLoadType()
Property: jsxloadtype
Allowed Values:

Annotation

The annotation comment visible in the Component Hierarchy palette.
Property: jsxannotation

Help ID

A unique ID for use with context-sensitive help.
Getter: getHelpId()
Setter: setHelpId()
Property: jsxhelpid