jsx3.gui.ImageButtonAPI


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.
ImageButton
TypeSets the type of image button.
StateSets the state of the image button.
Image
Over Image
Down Image
On Image
Disabled Image
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.
Box
BG ColorSets the background color.
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.
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

Type

Sets the type of image button.
Default Value: Normal (jsx3.gui.ImageButton.TYPE_NORMAL)
Getter: getType()
Setter: setType()
Property: jsxtype
Allowed Values:

State

Sets the state of the image button.
Default Value: Off (jsx3.gui.ImageButton.STATE_OFF)
Getter: getState()
Setter: setState()
Property: jsxstate
Allowed Values:

Image

No description provided.
Property: jsximage

Over Image

No description provided.
Property: jsxoverimage

Down Image

No description provided.
Property: jsxdownimage

On Image

No description provided.
Property: jsxonimage

Disabled Image

No description provided.
Property: jsxdisabledimage

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:

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

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

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