RealCombobox

A high-precision numeric entry control featuring both a pop-up menu and an entry field.

Methods:

addEventListener, getElements, removeEventListener, toSource, toSpecifier

Objects:

Boolean, EventListeners, Events, Number, Object, String

Hierarchy:

Superclass: Widget

Class: RealCombobox

Property Listing

Property

Type

Access

Description

editContents

String

read/write

The default value in an editbox control. Note: Do not specify both edit contents and edit value. If both are specified, the one that occurs later in the script is used.

editValue

Number

read/write

The real number default value of the editbox or combobox. Note: For measurement controls, the value is interpreted in points. The points value is converted to edit units when the dialog opens. Note: Do not specify both edit value and edit contents. If both are specified, the one that occurs later in the script is used.

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 RealCombobox.

index

Number

readonly

The index of the RealCombobox within its containing object.

isValid

Boolean

readonly

Returns true if the object specifier resolves to valid objects.

largeNudge

Number

read/write

The amount to increment/decrement the value when a user selects the control and holds down the Shift key while pressing an arrow key on the keyboard.

maximumValue

Number

read/write

The maximum value that a user is allowed to type in a numeric editbox or combobox. Note: The value for a measurement editbox or combobox is interpreted in points, regardless of the edit units specified for the control. The points value is converted automatically to the edit unit when the dialog is opened.

minWidth

Number

read/write

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

minimumValue

Number

read/write

The minumim value that a user is allowed to type in a numeric editbox or combobox. Note: The value for a measurement editbox or combobox is interpreted in points, regardless of the edit units specified for the control. The points value is converted automatically to the edit unit when the dialog is opened.

parent

DialogRow

EnablingGroup

BorderPanel

DialogColumn

readonly

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

properties

Object

read/write

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

smallNudge

Number

read/write

The amount to increment/decrement the value when the user selects the control and presses an arrow key on the keyboard.

stringList

Array of String

read/write

The menu items on a dropdown or combobox control, as an array of strings.

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)

RealCombobox 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 RealCombobox.

String toSpecifier ()

Retrieves the object specifier.

Object of

Event.parent

EventListener.parent

MutationEvent.parent

Return

RealComboboxes.add()

RealCombobox.getElements()

RealComboboxes.anyItem()

RealComboboxes.everyItem()

RealComboboxes.nextItem()

RealComboboxes.previousItem()

RealComboboxes.itemByID()

RealComboboxes.item()

RealComboboxes.[]()

RealComboboxes.itemByRange()

RealComboboxes.firstItem()

RealComboboxes.lastItem()

RealComboboxes.middleItem()