jsx3.gui.TreeAPI


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.
Tree
EnabledSets whether or not the view for this item is enabled and mouse/keyboard events will be listened to.
RequiredDetermines if the form input field is required.
Multi-SelectSets whether the tree supports multi-select or single-select.
Close IconThe 16x16 transparent .gif used to signal that clicking the item collapses its contents.
Open IconThe 16x16 transparent .gif used to signal that clicking the item displays/expands its contents.
IconThe icon to use for items in the tree.
Can Drag FromIf true (1) (Enabled), this object supports drag events and allows any contained item to be dragged and dropped on another container supporting drop.
Can Drop OnIf true (1) (Enabled), this object can be the target of drop events.
Show Root NodeWhether to show the root node in the tree.
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.
XSL Cache IdDeprecated.
XSL StringDeprecated.
XSL URLDeprecated.
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.
BorderSets the CSS border definition.
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.
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

Enabled

Sets whether or not the view for this item is enabled and mouse/keyboard events will be listened to.
Default Value: Enabled (jsx3.gui.Form.STATEENABLED)
Getter: getEnabled()
Setter: setEnabled()
Property: jsxenabled
Allowed Values:

Required

Determines if the form input field is required.
Default Value: Optional (jsx3.gui.Form.OPTIONAL)
Getter: getRequired()
Setter: setRequired()
Property: jsxrequired
Allowed Values:

Multi-Select

Sets whether the tree supports multi-select or single-select.
Default Value: Single-Select (jsx3.gui.Tree.SINGLE)
Getter: getMultiSelect()
Setter: setMultiSelect()
Property: jsxmultiselect
Allowed Values:

Close Icon

The 16x16 transparent .gif used to signal that clicking the item collapses its contents.
Default Value: jsx3.gui.Tree.ICONMINUS. See the API documentation for this component.
Getter: getIconMinus()
Setter: setIconMinus()
Property: jsxiconminus

Open Icon

The 16x16 transparent .gif used to signal that clicking the item displays/expands its contents.
Default Value: jsx3.gui.Tree.ICONPLUS. See the API documentation for this component.
Getter: getIconPlus()
Setter: setIconPlus()
Property: jsxiconplus

Icon

The icon to use for items in the tree.
Default Value: jsx3.gui.Tree.ICON. See the API documentation for this component.
Getter: getIcon()
Setter: setIcon()
Property: jsxicon

Can Drag From

If true (1) (Enabled), this object supports drag events and allows any contained item to be dragged and dropped on another container supporting drop.
Default Value: Disabled (jsx3.Boolean.FALSE)
Getter: getCanDrag()
Setter: setCanDrag()
Property: jsxdrag
Allowed Values:

Can Drop On

If true (1) (Enabled), this object can be the target of drop events.
Default Value: Disabled (jsx3.Boolean.FALSE)
Getter: getCanDrop()
Setter: getCanDrop()
Property: jsxdrop
Allowed Values:

Show Root Node

Whether to show the root node in the tree.
Default Value: Show (jsx3.Boolean.TRUE)
Getter: getRoot()
Setter: setRoot()
Property: jsxuseroot
Allowed Values:

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:

XSL Cache Id

Deprecated.
Sets the cache ID for the XSL document this object is mapped to.
Default Value: Unique ID assigned by the system
Getter: getXSLId()
Setter: setXSLId()
Property: jsxxslid

XSL String

Deprecated.
Sets the XSL document as a string.
Getter: getXSLString()
Setter: setXSLString()
Property: jsxxsl

XSL URL

Deprecated.
Sets the URL for the resource. This resource is synchronously loaded when this object is painted on-screen.
Getter: getXSLURL()
Setter: setXSLURL()
Property: jsxxslurl

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

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

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:

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