jsx3.gui.BlockXAPI


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
Relative XYSets whether to place this object relatively or absolutely with respect to its container.
LeftSets the position of this object from left edge of container.
TopSets the position of this object from top edge of container.
WidthSets the width of the control as implied pixels or a percentage.
HeightSets the height of the control in pixels or percentage.
Z-IndexIf this object is absolutely positioned, sets the CSS z-index.
BlockX
Tag NameSets the HTML tag to use when rendering this object on-screen.
XML/XSL
XML Cache IdSets the cache ID for the XML document this object is mapped to.
XML StringSets an XML document as a string.
XML URLSets the URL for the resource.
XML TransformersA comma-separated list of XSLT transformers.
Share ResourcesIf set to Share, this object does not delete its associated document from the cache when removed from the DOM.
XML AsyncIf set to Asynchronous and the XML data source of this control is loaded from a URL, then the data is loaded asynchronously and a loading message is displayed in this control until the data loads.
XML BindIf set to Bound this control automatically repaints every time its XML cache document changes.
Font
Font NameSets the name of the font family.
Font SizeSets the point size of the font.
Font WeightSets the weight of the font, such as bold or normal.
ColorSets the color of the font.
Box
BG ColorSets the background color.
BackgroundSets the CSS background definition, such as background-image:url(abc.gif);background-repeat:repeat-x;.
PaddingSets the white-space gap between the outer edge/border of this object to its inner content.
MarginSets the gap between this object's border and its bounding box.
BorderSets the CSS border definition.
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.
CSS Rule NameSets the named CSS rule(s) to use.
DisplaySets the CSS display property.
VisibilitySets the CSS visibility property.
Interaction
CursorSets the CSS cursor definition, such as default, wait, or col-resize.
Bound MenuSets the jsxname property for the context menu instance to display on a right-click.
Accessibility
Tab IndexSets the tab index.
TooltipSets the text displayed when hovered over this object (text only).
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

Relative XY

Sets whether to place this object relatively or absolutely with respect to its container.
Default Value: Relative (jsx3.gui.Block.RELATIVE)
Getter: getRelativePosition()
Setter: setRelativePosition()
Property: jsxrelativeposition
Allowed Values:

Left

Sets the position of this object from left edge of container. If this object is absolutely positioned, this value is applied as an implied pixel or a percentage. For example, 10 or 15%.
Default Value: If absolutely positioned, the default is 0. If relatively positioned, the default is empty.
Getter: getLeft()
Setter: setLeft()
Property: jsxleft

Top

Sets the position of this object from top edge of container. If this object is absolutely positioned, this value is applied as an implied pixel or a percentage. For example, 10 or 15%.
Default Value: If absolutely positioned, the default is 0. If relatively positioned, the default is empty.
Getter: getTop()
Setter: setTop()
Property: jsxtop

Width

Sets the width of the control as implied pixels or a percentage. For example, 100 or 25%.
Default Value: Empty
Getter: getWidth()
Setter: setWidth()
Property: jsxwidth

Height

Sets the height of the control in pixels or percentage. For example, 100 or 25%.
Default Value: Empty
Getter: getHeight()
Setter: setHeight()
Property: jsxheight

Z-Index

If this object is absolutely positioned, sets the CSS z-index. The z-index sets the stack order of an element.
Default Value: 1
Getter: getZIndex()
Setter: setZIndex()
Property: jsxzindex

Tag Name

Sets the HTML tag to use when rendering this object on-screen.
Default Value: span
Getter: getTagName()
Setter: setTagName()
Property: jsxtagname

XML Cache Id

Sets the cache ID for the XML document this object is mapped to.
Default Value: Unique ID assigned by the system
Getter: getXMLId()
Setter: setXMLId()
Property: jsxxmlid

XML String

Sets an XML document as a string.
Getter: getXMLString()
Setter: setXMLString()
Property: jsxxml

XML URL

Sets the URL for the resource. This resource is synchronously loaded when this object is painted on-screen.
Getter: getXMLURL()
Setter: setXMLURL()
Property: jsxxmlurl

XML Transformers

A comma-separated list of XSLT transformers. The source XML will be transformed in series by each of the transformers listed here before being placed in the XML cache. Each transformer is either a URI to an XSLT file or the XML cache id of an XSLT document.
Getter: getXMLTransformers()
Setter: setXMLTransformers()
Property: jsxxmltrans

Share Resources

If set to Share, this object does not delete its associated document from the cache when removed from the DOM.
Default Value: Cleanup (jsx3.xml.Cacheable.CLEANUPRESOURCES)
Getter: getShareResources()
Setter: setShareResources()
Property: jsxshare
Allowed Values:

XML Async

If set to Asynchronous and the XML data source of this control is loaded from a URL, then the data is loaded asynchronously and a loading message is displayed in this control until the data loads.
Default Value: Synchronous (jsx3.Boolean.FALSE)
Getter: getXmlAsync()
Setter: setXmlAsync()
Property: jsxxmlasync
Allowed Values:

XML Bind

If set to Bound this control automatically repaints every time its XML cache document changes.
Default Value: Not Bound (jsx3.Boolean.FALSE)
Getter: getXmlBind()
Setter: setXmlBind()
Property: jsxxmlbind
Allowed Values:

Font Name

Sets the name of the font family.
Default Value: jsx3.gui.Block.DEFAULTFONTNAME
Getter: getFontName()
Setter: setFontName()
Property: jsxfontname

Font Size

Sets the point size of the font.
Default Value: jsx3.gui.Block.DEFAULTFONTSIZE
Getter: getFontSize()
Setter: setFontSize()
Property: jsxfontsize

Font Weight

Sets the weight of the font, such as bold or normal.
Default Value: Normal (jsx3.gui.Block.FONTNORMAL)
Getter: getFontWeight()
Setter: setFontWeight()
Property: jsxfontweight
Allowed Values:

Color

Sets the color of the font. Accepts CSS values, such as predefined color names, RGB, or hexadecimal values. For example, red, rgb(255,0,0), or #ff0000.
Default Value: jsx3.gui.Block.DEFAULTCOLOR
Getter: getColor()
Setter: setColor()
Property: jsxcolor

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

Padding

Sets the white-space gap between the outer edge/border of this object to its inner content. Specified as one or four pixel values (top, right, bottom, and left). For example, 5 or 8 4 8 4.
Default Value: Empty
Getter: getPadding()
Setter: setPadding()
Property: jsxpadding

Margin

Sets the gap between this object's border and its bounding box. Specified as one or four pixel values (top, right, bottom, and left). For example, 2 or 4 2 4 2. CSS syntax is also supported but reduces performance.
Default Value: Empty
Getter: getMargin()
Setter: setMargin()
Property: jsxmargin

Border

Sets the CSS border definition. Specified as one or four value sets (top, right, bottom, and left). Specified as: style width color. For example, solid 1px red;dashed 2px red;double 3px black; solid 1px red;.
Default Value: Empty
Getter: getBorder()
Setter: setBorder()
Property: jsxborder

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

CSS Rule Name

Sets the named CSS rule(s) to use. Rules that specify border-width, padding, margin, width, and height are strongly discouraged. Multiple rules may be specified, delimited with a space. For example, label emphasis. Since some controls are composited from multiple HTML elements, some rule styles may not cascade to nested elements.

Dynamic Properties are the preferred method for applying global styles.
Getter: getClassName()
Setter: setClassName()
Property: jsxclassname

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:

Cursor

Sets the CSS cursor definition, such as default, wait, or col-resize.
Default Value: Empty
Getter: getCursor()
Setter: setCursor()
Property: jsxcursor

Bound Menu

Sets the jsxname property for the context menu instance to display on a right-click.
Getter: getMenu()
Setter: setMenu()
Property: jsxmenu

Tab Index

Sets the tab index. When tabbing between controls, the index group this component belongs to.
Default Value: Empty
Getter: getIndex()
Setter: setIndex()
Property: jsxindex

Tooltip

Sets the text displayed when hovered over this object (text only).
Default Value: Empty
Getter: getTip()
Setter: setTip()
Property: jsxtip

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