Widget

Generic term for an object in a dialog column or dialog row, including dialog controls such as radio button groups, checkboxes, editboxes, dropdowns, and comboboxes; static text objects; enabling groups; border panels; and nested dialog columns and dialog rows. For information, see dialog column, dialog row, static text, border panel, enabling group, radiobutton group, checkbox control, angle editbox, angle combobox, integer editbox, integer combobox, measurement editbox, measurement combobox, percent editbox, percent combobox, real editbox, real combobox, and text editbox.

Methods:

addEventListener, getElements, removeEventListener, toSource, toSpecifier

Objects:

Boolean, EventListeners, Events, Number, Object,

Hierarchy:

Class: Widget

Subclasses: TextEditbox | StaticText | Dropdown | CheckboxControl | RadiobuttonGroup | RadiobuttonControl | IntegerEditbox | IntegerCombobox | EnablingGroup | AngleCombobox | PercentCombobox | RealEditbox | PercentEditbox | AngleEditbox | RealCombobox | MeasurementCombobox | MeasurementEditbox | BorderPanel

Property Listing

Property

Type

Access

Description

eventListeners

EventListeners EventListener

readonly

A collection of event listeners.

events

Events Event

readonly

A collection of events.

id

Number

readonly

The unique ID of the Widget.

index

Number

readonly

The index of the Widget within its containing object.

isValid

Boolean

readonly

Returns true if the object specifier resolves to valid objects.

minWidth

Number

read/write

The width of the control. For an editbox or combobox, specifies the minimum width of the box.

parent

BorderPanel

DialogRow

EnablingGroup

DialogColumn

RadiobuttonGroup

readonly

The parent of the Widget (a DialogColumn, DialogRow, EnablingGroup, BorderPanel or RadiobuttonGroup).

properties

Object

read/write

A property that allows setting of several properties at the same time.

Method Listing

EventListener addEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Adds an event listener.

Parameter

Type

Description

eventType

String

The event type.

handler

File

JavaScriptFunction

The event handler. Can accept: File or JavaScript Function.

captures

Boolean

This parameter is obsolete. (Optional)

(default: false)

Widget getElements ()

Resolves the object specifier, creating an array of object references.

Boolean removeEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Removes the event listener.

Parameter

Type

Description

eventType

String

The registered event type.

handler

File

JavaScriptFunction

The registered event handler. Can accept: File or JavaScript Function.

captures

Boolean

This parameter is obsolete. (Optional)

(default: false)

String toSource ()

Generates a string which, if executed, will return the Widget.

String toSpecifier ()

Retrieves the object specifier.

Object of

Event.parent

EventListener.parent

MutationEvent.parent

Return

Widget.getElements()

Widgets.anyItem()

Widgets.everyItem()

Widgets.nextItem()

Widgets.previousItem()

Widgets.itemByID()

Widgets.item()

Widgets.[]()

Widgets.itemByRange()

Widgets.firstItem()

Widgets.lastItem()

Widgets.middleItem()