Adobe InCopy CS5 (7.0) Object Model JS: Page

InCopy CS5

Class

Page

 A page.

QuickLinks

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

Hierarchy

MasterSpread | Spread
Page
Event | EventListener | FormField | MarginPreference | MutationEvent | PageItem | Preference

Properties

PropertyTypeAccessDescription
allGraphics Array of Graphic readonlyLists all graphics contained by the Page.
allPageItems Array of PageItem readonlyLists all page items contained by the Page.
appliedMasterMasterSpreadNothingEnum readonlyThe master spread applied to the Page. Can also accept: NothingEnum enumerator.
appliedSectionSection readonlyThe section to which the page belongs.
appliedTrapPresetString
TrapPreset
r/wThe trap preset applied to the page. Can also accept: String.
bounds Array of Measurement Unit (Number or String) readonlyThe bounds of the Page, in the format [y1, x1, y2, x2].
buttonsButtons readonlyA collection of buttons.
documentOffsetnumber readonlyThe sequential number of the page within the document.
epstextsEPSTexts readonlyEPSTexts
eventListenersEventListeners readonlyA collection of event listeners.
eventsEvents readonlyA collection of events.
formFieldsFormFields readonlyA collection of form fields.
graphicLinesGraphicLines readonlyA collection of graphic lines.
groupsGroups readonlyA collection of groups.
guidesGuides readonlyA collection of guides.
idnumber readonlyThe unique ID of the Page.
indexnumber readonlyThe index of the Page 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.
marginPreferencesMarginPreference readonlyMargin preference settings.
masterPageItems Array of
Graphics
Guides
Movies
PageItems
Sounds
readonlyThe items on a specified document page that originated on the applied master page and have not been overridden or detached. Can return: Array of PageItems, Guides, Graphics, Movies or Sounds.
masterPageTransformTransformationMatrix r/wThe transform applied to the master page before it is applied to Page.
multiStateObjectsMultiStateObjects readonlyA collection of multi-state objects.
namestring readonlyThe name of the Page.
ovalsOvals readonlyA collection of ellipses.
pageItemsPageItems 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.
parentMasterSpread
Spread
readonlyThe parent of the Page (a Spread or MasterSpread).
polygonsPolygons readonlyA collection of polygons.
preferencesPreferences readonlyA collection of preferences objects.
propertiesObject r/wA property that allows setting of several properties at the same time.
rectanglesRectangles readonlyA collection of rectangles.
sidePageSideOptions:
PageSideOptions.RIGHT_HAND
PageSideOptions.LEFT_HAND
PageSideOptions.SINGLE_SIDED
readonlyThe side of the binding spine on which to place the page within the spread.
splineItemsSplineItems readonlyThe spline items collection.
tabOrder Array of Button r/wThe order in which the focus moves to different buttons in the PDF when the tab key is pressed.
textFramesTextFrames 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 Page 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 Page.

string toSpecifier ()
Retrieves the object specifier.

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

Button.parentPage

EPS.parentPage

EPSText.parentPage

FormField.parentPage

Graphic.parentPage

GraphicLine.parentPage

Group.parentPage

Guide.parentPage

Image.parentPage

ImportedPage.parentPage

MarginPreference.parent

MediaItem.parentPage

Movie.parentPage

MultiStateObject.parentPage

Oval.parentPage

PDF.parentPage

PICT.parentPage

PageItem.parentPage

Polygon.parentPage

Rectangle.parentPage

Section.pageStart

Sound.parentPage

SplineItem.parentPage

TextFrame.parentPage

WMF.parentPage

Window.activePage

Used in:

HyperlinkExternalPageDestination HyperlinkExternalPageDestinations.add ([destination: Page][, withProperties: Object])

Page Pages.nextItem (obj: Page)

Page Pages.previousItem (obj: Page)

Return

Array of Page Page.getElements ()

Page Pages.[] (index: number)

Page Pages.anyItem ()

Array of Page Pages.everyItem ()

Page Pages.firstItem ()

Page Pages.item (index: varies)

Page Pages.itemByID (id: number)

Page Pages.itemByName (name: string)

Array of Page Pages.itemByRange (from: varies, to: varies)

Page Pages.lastItem ()

Page Pages.middleItem ()

Page Pages.nextItem (obj: Page)

Page Pages.previousItem (obj: Page)

Jongware, 23-Mar-2011 v3.0.3dContents :: Index