Adobe InCopy CS6 (8.0) Object Model JS: Spread

InCopy CS6

Class

Spread

 A spread.

QuickLinks

addEventListener, extractLabel, getElements, insertLabel, removeEventListener, resolve, toSource, toSpecifier, transform, transformValuesOf

Hierarchy

Document
Spread
Button | CheckBox | ComboBox | EPSText | Event | EventListener | FormField | GraphicLine | Group | Guide | ListBox | MultiStateObject | MutationEvent | Oval | Page | PageItem | Polygon | RadioButton | Rectangle | SignatureField | SplineItem | TextBox | TextFrame

Properties

PropertyTypeAccessDescription
allGraphics Array of Graphic readonlyLists all graphics contained by the Spread.
allPageItems Array of PageItem readonlyLists all page items contained by the Spread.
allowPageShufflebool readonlyIf true, guarantees that when pages are added to a spread it will contain a maximum of two pages. If false, allows pages to be added or moved into existing spreads. For override information, see preserve layout when shuffling.
appliedMasterMasterSpreadNothingEnum readonlyThe master spread applied to the Spread. Can also accept: NothingEnum enumerator.
buttonsButtons Button readonlyA collection of buttons.
checkBoxesCheckBoxes readonlyA collection of checkboxes.
comboBoxesComboBoxes readonlyA collection of comboboxes.
epstextsEPSTexts EPSText readonlyEPSTexts
eventListenersEventListeners EventListener readonlyA collection of event listeners.
eventsEvents Event readonlyA collection of events.
formFieldsFormFields FormField readonlyA collection of form fields.
graphicLinesGraphicLines GraphicLine readonlyA collection of graphic lines.
groupsGroups Group readonlyA collection of groups.
guidesGuides Guide readonlyA collection of guides.
idnumber readonlyThe unique ID of the Spread.
idmlComponentNamestring r/wThe IDML component name of the Spread.
indexnumber readonlyThe index of the Spread within its containing object.
isValidbool readonlyReturns true if the object specifier resolves to valid objects.
labelstring r/wA property that can be set to any string.
listBoxesListBoxes readonlyA collection of listboxes.
multiStateObjectsMultiStateObjects MultiStateObject readonlyA collection of multi-state objects.
namestring r/wThe name of the Spread; this is an alias to the Spread's label property.
ovalsOvals Oval readonlyA collection of ellipses.
pageItemsPageItems PageItem readonlyThe page items collection, which can be used to process all page items in a container (such as a document, page, or group), regardless of type.
pagesPages Page readonlyA collection of pages.
parentDocument readonlyThe parent of the Spread (a Document).
polygonsPolygons Polygon readonlyA collection of polygons.
propertiesObject r/wA property that allows setting of several properties at the same time.
radioButtonsRadioButtons RadioButton readonlyA collection of radio buttons.
rectanglesRectangles Rectangle readonlyA collection of rectangles.
signatureFieldsSignatureFields SignatureField readonlyA collection of signature fields.
splineItemsSplineItems SplineItem readonlyThe spline items collection.
textBoxesTextBoxes readonlyA collection of text boxes.
textFramesTextFrames TextFrame readonlyA collection of text frames.

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)

string extractLabel (key: string)
Gets the label value associated with the specified key.

ParameterTypeDescription
keystringThe key.

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

void insertLabel (key: string, value: string)
Sets the label to the value associated with the specified key.

ParameterTypeDescription
keystringThe key.
valuestringThe value.

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)

any resolve (location: varies, in: CoordinateSpaces[, consideringRulerUnits: bool=false])
Get the coordinates of the given location in the specified coordinate system.

ParameterTypeDescription
locationAnchorPoint
AnchorPoint
Array of 2 Reals
Array of Arrays of 2 Reals
BoundingBoxLimits
CoordinateSpaces
Long Integers
The location requested. Can accept: Array of 2 Reals, AnchorPoint enumerator or Array of Arrays of 2 Reals, CoordinateSpaces enumerators, AnchorPoint enumerators, BoundingBoxLimits enumerators or Long Integers.
inCoordinateSpaces:
CoordinateSpaces.PASTEBOARD_COORDINATES
CoordinateSpaces.PARENT_COORDINATES
CoordinateSpaces.INNER_COORDINATES
CoordinateSpaces.SPREAD_COORDINATES
The coordinate space to use.
consideringRulerUnitsboolIf true then a ruler location is interpreted using ruler units rather than points. The default value is false. This parameter has no effect unless the reference point is specified relative to a page. (Optional) (default: false)

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

string toSpecifier ()
Retrieves the object specifier.

void transform (in: CoordinateSpaces, from: varies, withMatrix: varies[, replacingCurrent: varies][, consideringRulerUnits: bool=false])
Transform the page item.

ParameterTypeDescription
inCoordinateSpaces:
CoordinateSpaces.PASTEBOARD_COORDINATES
CoordinateSpaces.PARENT_COORDINATES
CoordinateSpaces.INNER_COORDINATES
CoordinateSpaces.SPREAD_COORDINATES
The coordinate space to use
fromAnchorPoint
AnchorPoint
Array of 2 Reals
Array of Arrays of 2 Reals
BoundingBoxLimits
CoordinateSpaces
Long Integers
The temporary origin during the transformation. Can accept: Array of 2 Reals, AnchorPoint enumerator or Array of Arrays of 2 Reals, CoordinateSpaces enumerators, AnchorPoint enumerators, BoundingBoxLimits enumerators or Long Integers.
withMatrix Array of 6 Reals
TransformationMatrix
Transform matrix. Can accept: Array of 6 Reals or TransformationMatrix.
replacingCurrent Array of MatrixContent
Long Integer
MatrixContent
Transform components to consider; providing this optional parameter causes the target's existing transform components to be replaced with new values. Without this parameter, the given matrix is concatenated onto the target's existing transform combining the effect of the two. Can accept: MatrixContent enumerator, Array of MatrixContent enumerators or Long Integer. (Optional)
consideringRulerUnitsboolIf true then a ruler based origin is interpreted using ruler units rather than points. The default value is false. This parameter has no effect unless the reference point is specified relative to a page. (Optional) (default: false)

Array of TransformationMatrix transformValuesOf (in: CoordinateSpaces)
Get the transformation values of the page item.

ParameterTypeDescription
inCoordinateSpaces:
CoordinateSpaces.PASTEBOARD_COORDINATES
CoordinateSpaces.PARENT_COORDINATES
CoordinateSpaces.INNER_COORDINATES
CoordinateSpaces.SPREAD_COORDINATES
The coordinate space to use

Element of

Guide.parent

Page.parent

Window.activeSpread

Used in:

Spread Spreads.nextItem (obj: Spread)

Spread Spreads.previousItem (obj: Spread)

Return

Array of Spread Spread.getElements ()

Spread Spreads.[] (index: number)

Spread Spreads.anyItem ()

Array of Spread Spreads.everyItem ()

Spread Spreads.firstItem ()

Spread Spreads.item (index: varies)

Spread Spreads.itemByID (id: number)

Spread Spreads.itemByName (name: string)

Array of Spread Spreads.itemByRange (from: varies, to: varies)

Spread Spreads.lastItem ()

Spread Spreads.middleItem ()

Spread Spreads.nextItem (obj: Spread)

Spread Spreads.previousItem (obj: Spread)

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