Adobe InDesign CS5 (7.0) Object Model JS: DocumentPreference

InDesign CS5

Class

DocumentPreference

 Document preferences. Base Class: Preference

QuickLinks

addEventListener, getElements, removeEventListener, toSource, toSpecifier

Hierarchy

Application | Document
Preference
DocumentPreference
Event | EventListener | MutationEvent

Properties

PropertyTypeAccessDescription
allowPageShufflebool r/wIf 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) r/wThe 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) r/wThe 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) r/wThe 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) r/wThe amount to offset the top document bleed.
documentBleedUniformSizebool r/wIf true, uses the document bleed top offset value for bleed offset measurements on all sides of the document. The default setting is true.
documentSlugUniformSizebool r/wIf true, uses the slug top offset value for slug measurements on all sides of the document. The default value is false.
eventListenersEventListeners readonlyA collection of event listeners.
eventsEvents readonlyA collection of events.
facingPagesbool r/wIf true, the document has facing pages.
intentDocumentIntentOptions:
DocumentIntentOptions.PRINT_INTENT
DocumentIntentOptions.WEB_INTENT
r/wThe 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 r/wIf true, the document A-master has auto textframes.
overprintBlackbool r/wIf 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 r/wThe number of pages in the document. (Range: 1 to 9999)
parentApplication
Document
readonlyThe parent of the DocumentPreference (a Application or Document).
preserveLayoutWhenShufflingbool r/wIf 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) r/wThe 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) r/wThe 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) r/wThe 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) r/wThe amount to offset the top slug.
snippetImportUsesOriginalLocationbool r/wIf true, causes UI-based snippet import to use original location for page items.
startPageNumbernumber (range: 1 - 999999) r/wThe 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.

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, 20-Jun-2010 v3.0.3dContents :: Index