Adobe InCopy CS5.5 (7.5) Object Model JS: DocumentPreference

InCopy CS5.5

Class

DocumentPreference

 Document preferences. Base Class: Preference

QuickLinks

addEventListener, getElements, removeEventListener, toSource, toSpecifier

Hierarchy

Application | Document
Preference
DocumentPreference
Event | EventListener | MutationEvent

Properties

PropertyTypeAccessDescription
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.
columnDirectionHorizontalOrVertical:
HorizontalOrVertical.HORIZONTAL
HorizontalOrVertical.VERTICAL
r/wThe direction of text in the column.
columnGuideColor3 Reals (0 - 255)
UIColors
r/wThe color of the column guides, specified either as an array of three doubles, each in the range 0 to 255 and representing R, G, and B values,, or as a UI color. Can return: Array of 3 Reals (0 - 255) or UIColors enumerator.
columnGuideLockedbool r/wIf true, locks column guides.
documentBleedBottomOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the bottom document bleed. Note: To set the bleed bottom offset, document bleed uniform size must be false.
documentBleedInsideOrLeftOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the inside or left document bleed. Note: To set the bleed inside or left offset, document bleed uniform size must be false.
documentBleedOutsideOrRightOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the outside or right document bleed. Note: To set the bleed outside or right offset, document bleed uniform size must be false.
documentBleedTopOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the top document bleed.
documentBleedUniformSizebool readonlyIf true, uses the document bleed top offset value for bleed offset measurements on all sides of the document. The default setting is true.
documentSlugUniformSizebool readonlyIf true, uses the slug top offset value for slug measurements on all sides of the document. The default value is false.
eventListenersEventListeners EventListener readonlyA collection of event listeners.
eventsEvents Event readonlyA collection of events.
facingPagesbool r/wIf true, the document has facing pages.
intentDocumentIntentOptions:
DocumentIntentOptions.PRINT_INTENT
DocumentIntentOptions.WEB_INTENT
readonlyThe intent for a document.
isValidbool readonlyReturns true if the object specifier resolves to valid objects.
marginGuideColor3 Reals (0 - 255)
UIColors
r/wThe color of the margin guides, specified either as an array of three doubles, each in the range 0 to 255, representing R, G, and B values, or as a UI color. Can return: Array of 3 Reals (0 - 255) or UIColors enumerator.
masterTextFramebool readonlyIf true, the document A-master has auto textframes.
overprintBlackbool readonlyIf true, overprints black when saving the document.
pageBindingPageBindingOptions:
PageBindingOptions.DEFAULT_VALUE
PageBindingOptions.RIGHT_TO_LEFT
PageBindingOptions.LEFT_TO_RIGHT
r/wThe placement of the page binding.
pageHeightMeasurement Unit (Number or String) r/wThe height of the page.
pageOrientationPageOrientation:
PageOrientation.LANDSCAPE
PageOrientation.PORTRAIT
r/wThe page orientation.
pageSizestring r/wThe size of the page.
pageWidthMeasurement Unit (Number or String) r/wThe width of the page.
pagesPerDocumentnumber readonlyThe number of pages in the document. (Range: 1 to 9999)
parentApplication
Document
readonlyThe parent of the DocumentPreference (a Application or Document).
preserveLayoutWhenShufflingbool readonlyIf true, preserves the layout of spreads that contained more than two pages when allow page shuffle was turned on. If false, changes multi-page spreads to two-page spreads if the spreads were created or changed since allow page shuffle was turned on.
propertiesObject r/wA property that allows setting of several properties at the same time.
slugBottomOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the bottom slug. Note: To set the slug bottom offset, document slug uniform size must be false.
slugInsideOrLeftOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the inside or left slug. Note: To set the slug inside or left offset, document slug uniform size must be false.
slugRightOrOutsideOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the outside or right slug. Note: To set the slug right or outside offset, document slug uniform size must be false.
slugTopOffsetMeasurement Unit (Number or String) readonlyThe amount to offset the top slug.
startPageNumbernumber (range: 1 - 999999) readonlyThe starting page number for a document. This is the same as the starting page number for the first section of a document. Default value is 1.
textAreaDepthnumber r/wThe depth of the text area.
textAreaDepthUnitTextAreaDepthUnit:
TextAreaDepthUnit.DEPTH_CHARS
TextAreaDepthUnit.DEPTH_WORDS
TextAreaDepthUnit.DEPTH_LINES
TextAreaDepthUnit.DEPTH_COLUMN_INCHES
TextAreaDepthUnit.DEPTH_PAGES
r/wThe unit in which to measure the text area depth.
textAreaWidthMeasurement Unit (Number or String) r/wThe width of the text area.

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

string toSpecifier ()
Retrieves the object specifier.

Element of

Application.documentPreferences

Document.documentPreferences

Return

Array of DocumentPreference DocumentPreference.getElements ()

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