Adobe InCopy CS6 (8.0) Object Model JS: MeasurementCombobox

InCopy CS6

Class

MeasurementCombobox

 A measurement entry control featuring both a pop-up menu and an entry field. Base Class: Widget

QuickLinks

addEventListener, getElements, removeEventListener, toSource, toSpecifier

Hierarchy

BorderPanel | DialogColumn | DialogRow | EnablingGroup
Widget
MeasurementCombobox
Event | EventListener | MutationEvent

Properties

PropertyTypeAccessDescription
editContentsstring r/wThe 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.
editUnitsMeasurementUnits:
MeasurementUnits.POINTS
MeasurementUnits.PICAS
MeasurementUnits.INCHES
MeasurementUnits.INCHES_DECIMAL
MeasurementUnits.MILLIMETERS
MeasurementUnits.CENTIMETERS
MeasurementUnits.CICEROS
MeasurementUnits.CUSTOM
MeasurementUnits.AGATES
MeasurementUnits.U
MeasurementUnits.BAI
MeasurementUnits.MILS
MeasurementUnits.PIXELS
MeasurementUnits.Q
MeasurementUnits.HA
MeasurementUnits.AMERICAN_POINTS
r/wThe measurement units to display in the measurement control.
editValuenumber r/wThe 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.
eventListenersEventListeners EventListener readonlyA collection of event listeners.
eventsEvents Event readonlyA collection of events.
idnumber readonlyThe unique ID of the MeasurementCombobox.
indexnumber readonlyThe index of the MeasurementCombobox within its containing object.
isValidbool readonlyReturns true if the object specifier resolves to valid objects.
largeNudgenumber r/wThe 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.
maximumValuenumber r/wThe 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.
minWidthnumber r/wThe width of the control. For an editbox or combobox, specifies the minimum width of the box.
minimumValuenumber r/wThe 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.
parentBorderPanel
DialogColumn
DialogRow
EnablingGroup
readonlyThe parent of the MeasurementCombobox (a DialogColumn, DialogRow, EnablingGroup or BorderPanel).
propertiesObject r/wA property that allows setting of several properties at the same time.
smallNudgenumber r/wThe amount to increment/decrement the value when the user selects the control and presses an arrow key on the keyboard.
stringList Array of string r/wThe menu items on a dropdown or combobox control, as an array of strings.

Methods

Instances

EventListener addEventListener (eventType: string, handler: varies[, captures: bool=false])
Adds an event listener.

ParameterTypeDescription
eventTypestringThe event type.
handlerFile
JavaScript Function
The event handler. Can accept: File or JavaScript Function.
capturesboolThis parameter is obsolete. (Optional) (default: false)

Array of MeasurementCombobox getElements ()
Resolves the object specifier, creating an array of object references.

bool removeEventListener (eventType: string, handler: varies[, captures: bool=false])
Removes the event listener.

ParameterTypeDescription
eventTypestringThe registered event type.
handlerFile
JavaScript Function
The registered event handler. Can accept: File or JavaScript Function.
capturesboolThis parameter is obsolete. (Optional) (default: false)

string toSource ()
Generates a string which, if executed, will return the MeasurementCombobox.

string toSpecifier ()
Retrieves the object specifier.

Used in:

MeasurementCombobox MeasurementComboboxes.nextItem (obj: MeasurementCombobox)

MeasurementCombobox MeasurementComboboxes.previousItem (obj: MeasurementCombobox)

Return

Array of MeasurementCombobox MeasurementCombobox.getElements ()

MeasurementCombobox MeasurementComboboxes.[] (index: number)

MeasurementCombobox MeasurementComboboxes.add ([withProperties: Object])

MeasurementCombobox MeasurementComboboxes.anyItem ()

Array of MeasurementCombobox MeasurementComboboxes.everyItem ()

MeasurementCombobox MeasurementComboboxes.firstItem ()

MeasurementCombobox MeasurementComboboxes.item (index: varies)

MeasurementCombobox MeasurementComboboxes.itemByID (id: number)

Array of MeasurementCombobox MeasurementComboboxes.itemByRange (from: varies, to: varies)

MeasurementCombobox MeasurementComboboxes.lastItem ()

MeasurementCombobox MeasurementComboboxes.middleItem ()

MeasurementCombobox MeasurementComboboxes.nextItem (obj: MeasurementCombobox)

MeasurementCombobox MeasurementComboboxes.previousItem (obj: MeasurementCombobox)

Jongware, 29-Apr-2012 v3.0.3iContents :: Index