Document

A document.

Go to Property Listing | Method Listing

Objects:

AnchoredObjectDefault, AnchoredObjectSetting, Assignments, BaselineFrameGridOption, Bookmarks, Boolean, ButtonPreference, Buttons, CellStyles, CharacterStyles, ColorSettingsPolicy, Colors, DTDs, DashedStrokeStyles, DataMerge, DataMergeImagePlaceholders, DataMergeOption, DataMergeTextPlaceholders, DictionaryPreference, DocumentPreference, DottedStrokeStyles, EditingState, File, Fonts, FootnoteOption, FormFields, GalleyPreference, Gradients, Graphic, GraphicLines, GridPreference, Groups, GuidePreference, Guides, HyperlinkExternalPageDestinations, HyperlinkPageDestinations, HyperlinkPageItemSources, HyperlinkTextDestinations, HyperlinkTextSources, HyperlinkURLDestinations, Hyperlinks, HyphenationExceptions, IndexOptions, Indexes, Inks, Languages, Layers, LayoutAdjustmentPreference, LayoutWindows, Links, MarginPreference, MasterSpreads, MetadataPreference, MixedInkGroups, MixedInks, NothingEnum, Number, Object, ObjectStyles, Ovals, PackageForGoLivePreference, PageItem, PageItems, Pages, ParagraphStyles, PasteboardPreference, Polygons, PrintPreference, Rectangles, RenderingIntent, Sections, Spreads, Stories, StoryPreference, StoryWindows, String, StripedStrokeStyles, StrokeStyles, Swatch, Swatches, TOCStyles, TableStyles, TextDefault, TextFramePreference, TextFrames, TextPreference, Tints, TransparencyPreference, TrapPresets, ValidationErrors, VersionState, ViewPreference, Windows, XMLComments, XMLElements, XMLExportMaps, XMLExportPreference, XMLImportMaps, XMLImportPreference, XMLInstructions, XMLItem, XMLItems, XMLPreference, XMLTags, XMLViewPreference

Property Listing

Property	Type	Access	Description
accurateLABSpots	Boolean	read/write	If true, uses LAB alternates for spot colors when available.
afterBlendingIntent	RenderingIntent RenderingIntent.ABSOLUTE_COLORIMETRIC RenderingIntent.PERCEPTUAL RenderingIntent.RELATIVE_COLORIMETRIC RenderingIntent.SATURATION RenderingIntent.USE_COLOR_SETTINGS	read/write	The rendering intent for colors that result from transparency interactions on the page after blending.
allGraphics	Array of Graphic	readonly	Lists all graphics contained by the Document.
allPageItems	Array of PageItem	readonly	Lists all page items contained by the Document.
anchoredObjectDefaults	AnchoredObjectDefault	readonly	Anchored object default settings.
anchoredObjectSettings	AnchoredObjectSetting	readonly	Anchored object settings.
assignments	Assignments Assignment	readonly	A collection of assignments.
associatedXMLElement	XMLItem	readonly	The XML element associated with the Document.
baselineFrameGridOptions	BaselineFrameGridOption	readonly	Baseline frame grid option settings.
bookmarks	Bookmarks Bookmark	readonly	A collection of bookmarks.
buttonPreferences	ButtonPreference	readonly	Button preference settings.
buttons	Buttons Button	readonly	A collection of buttons.
cellStyles	CellStyles CellStyle	readonly	All cell styles
characterStyles	CharacterStyles CharacterStyle	readonly	A collection of character styles.
cmykPolicy	ColorSettingsPolicy ColorSettingsPolicy.COLOR_POLICY_OFF ColorSettingsPolicy.COMBINATION_OF_PRESERVE_AND_SAFE_CMYK ColorSettingsPolicy.CONVERT_TO_WORKING_SPACE ColorSettingsPolicy.PRESERVE_EMBEDDED_PROFILES	read/write	The policy for handling colors in a CMYK color model, including reading and embedding color profiles, mismatches between embedded color profiles and the working space, and moving colors from one document to another.
cmykProfile	String	read/write	The current CMYK profile.
cmykProfileList	Array of String	readonly	A list of valid CMYK profiles.
colors	Colors Color	readonly	A collection of colors.
dashedStrokeStyles	DashedStrokeStyles DashedStrokeStyle	readonly	A collection of dashed stroke styles.
dataMergeImagePlaceholders	DataMergeImagePlaceholders DataMergeImagePlaceholder	readonly	A collection of data merge image placeholders.
dataMergeOptions	DataMergeOption	readonly	The data merge option properties that define the data merge.
dataMergeProperties	DataMerge	readonly	Data merge properties that define data merge fields and preferences.
dataMergeTextPlaceholders	DataMergeTextPlaceholders DataMergeTextPlaceholder	readonly	A collection of data merge text placeholders.
defaultImageIntent	RenderingIntent RenderingIntent.ABSOLUTE_COLORIMETRIC RenderingIntent.PERCEPTUAL RenderingIntent.RELATIVE_COLORIMETRIC RenderingIntent.SATURATION RenderingIntent.USE_COLOR_SETTINGS	read/write	The rendering intent for bitmap images.
dictionaryPreferences	DictionaryPreference	readonly	User dictionary preference settings.
documentPreferences	DocumentPreference	readonly	Document preference settings.
dottedStrokeStyles	DottedStrokeStyles DottedStrokeStyle	readonly	A collection of dotted stroke styles.
dtds	DTDs DTD	readonly	A collection of DTDs.
editingState	EditingState EditingState.EDITING_CONFLICT EditingState.EDITING_LOCALLY EditingState.EDITING_LOCALLY_LOCKED EditingState.EDITING_NOWHERE EditingState.EDITING_REMOTELY EditingState.EDITING_UNKNOWN	readonly	The Version Cue editing state of the file.
filePath	File	readonly	The full path to the file.
fonts	Fonts Font	readonly	A collection of fonts.
footnoteOptions	FootnoteOption	readonly	Footnote option settings.
formFields	FormFields FormField	readonly	A collection of form fields.
fullName	File	readonly	The full path to the Document, including the name of the Document.
galleyPreferences	GalleyPreference	readonly	Galley preference settings.
gradients	Gradients Gradient	readonly	A collection of gradients.
graphicLines	GraphicLines GraphicLine	readonly	A collection of graphic lines.
gridPreferences	GridPreference	readonly	Grid preference settings.
groups	Groups Group	readonly	A collection of groups.
guidePreferences	GuidePreference	readonly	Guide preference settings.
guides	Guides Guide	readonly	A collection of guides.
hyperlinkExternalPageDestinations	HyperlinkExternalPageDestinations HyperlinkExternalPageDestination	readonly	A collection of hyperlink external page destinations.
hyperlinkPageDestinations	HyperlinkPageDestinations HyperlinkPageDestination	readonly	A collection of hyperlink page destinations.
hyperlinkPageItemSources	HyperlinkPageItemSources HyperlinkPageItemSource	readonly	A collection of hyperlink page item sources.
hyperlinkTextDestinations	HyperlinkTextDestinations HyperlinkTextDestination	readonly	A collection of hyperlink text destinations.
hyperlinkTextSources	HyperlinkTextSources HyperlinkTextSource	readonly	A collection of hyperlink text sources.
hyperlinkURLDestinations	HyperlinkURLDestinations HyperlinkURLDestination	readonly	A collection of hyperlink URL destinations.
hyperlinks	Hyperlinks Hyperlink	readonly	A collection of hyperlinks.
hyphenationExceptions	HyphenationExceptions HyphenationException	readonly	A collection of hyphenation exceptions lists.
index	Number	readonly	The index of the Document within its containing object.
indexGenerationOptions	IndexOptions	readonly	The index options properties that define how an index is formatted.
indexes	Indexes	readonly	A collection of indexes.
inks	Inks Ink	readonly	A collection of inks.
label	String	read/write	A property that can be set to any string.
languages	Languages Language	readonly	A collection of languages.
layers	Layers Layer	readonly	A collection of layers.
layoutAdjustmentPreferences	LayoutAdjustmentPreference	readonly	Layout sdjustment preference settings.
layoutWindows	LayoutWindows LayoutWindow	readonly	A collection of layout windows.
links	Links Link	readonly	A collection of links.
marginPreferences	MarginPreference	readonly	Margin preference settings.
masterSpreads	MasterSpreads MasterSpread	readonly	A collection of master spreads.
metadataPreferences	MetadataPreference	readonly	Metadata preference settings.
mixedInkGroups	MixedInkGroups MixedInkGroup	readonly	A collection of mixed ink groups.
mixedInks	MixedInks MixedInk	readonly	A collection of mixed inks.
modified	Boolean	readonly	If true, the Document has been modified since it was last saved.
name	String	readonly	The name of the Document.
objectStyles	ObjectStyles ObjectStyle	readonly	A collection of object styles.
ovals	Ovals Oval	readonly	A collection of ellipses.
packageForGoLivePreferences	PackageForGoLivePreference	readonly	The Package For GoLive preference properties that define how a document is packaged for GoLive.
pageItems	PageItems PageItem	readonly	The 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.
pages	Pages Page	readonly	A collection of pages.
paragraphStyles	ParagraphStyles ParagraphStyle	readonly	A collection of paragraph styles.
parent	Application	readonly	The parent of the Document (a Application).
pasteboardPreferences	PasteboardPreference	readonly	Pasteboard preference settings.
polygons	Polygons Polygon	readonly	A collection of polygons.
printPreferences	PrintPreference	readonly	Print preference settings.
properties	Object	read/write	A property that allows setting of several properties at the same time.
rectangles	Rectangles Rectangle	readonly	A collection of rectangles.
redoHistory	Array of String	readonly	The names of the items in the redo stack.
redoName	String	readonly	The name of the action on the top of the redo stack.
rgbPolicy	ColorSettingsPolicy ColorSettingsPolicy.COLOR_POLICY_OFF ColorSettingsPolicy.COMBINATION_OF_PRESERVE_AND_SAFE_CMYK ColorSettingsPolicy.CONVERT_TO_WORKING_SPACE ColorSettingsPolicy.PRESERVE_EMBEDDED_PROFILES	read/write	The policy for handling colors in an RGB color model, including reading and embedding color profiles, handling mismatches between embedded color profiles and the working space, and moving colors from one document to another.
rgbProfile	String	read/write	The current RGB profile.
rgbProfileList	Array of String	readonly	A list of valid RGB profiles.
saved	Boolean	readonly	If true, the Document has been saved since it was created.
sections	Sections Section	readonly	A collection of sections.
selection	Array of Objects Object NothingEnum.NOTHING	read/write	The selection. Can return: Object, Array of Objects or NothingEnum enumerator.
solidColorIntent	RenderingIntent RenderingIntent.ABSOLUTE_COLORIMETRIC RenderingIntent.PERCEPTUAL RenderingIntent.RELATIVE_COLORIMETRIC RenderingIntent.SATURATION RenderingIntent.USE_COLOR_SETTINGS	read/write	The rendering intent for all vector art (areas of solid color) in native objects.
spreads	Spreads Spread	readonly	A collection of spreads.
stories	Stories Story	readonly	A collection of stories.
storyPreferences	StoryPreference	readonly	Story preference settings.
storyWindows	StoryWindows StoryWindow	readonly	A collection of story windows.
stripedStrokeStyles	StripedStrokeStyles StripedStrokeStyle	readonly	A collection of striped stroke styles.
strokeStyles	StrokeStyles StrokeStyle	readonly	A collection of stroke styles.
swatches	Swatches	readonly	A collection of swatches.
tableStyles	TableStyles TableStyle	readonly	All table styles
textDefaults	TextDefault	readonly	Text default settings.
textFramePreferences	TextFramePreference	readonly	Text frame preference settings.
textFrames	TextFrames TextFrame	readonly	A collection of text frames.
textPreferences	TextPreference	readonly	Text preference settings.
tints	Tints Tint	readonly	A collection of tints.
tocStyles	TOCStyles TOCStyle	readonly	A collection of TOC styles.
transparencyPreferences	TransparencyPreference	readonly	Transparency preference settings.
trapPresets	TrapPresets TrapPreset	readonly	A collection of trap presets.
undoHistory	Array of String	readonly	The names of the items in the undo stack.
undoName	String	readonly	The name of the action on the top of the undo stack.
unusedSwatches	Array of Swatch	readonly	The swatches that are not being used.
validationErrors	ValidationErrors ValidationError	readonly	A collection of XML validation errors.
versionState	VersionState VersionState.LOCAL_NEWER VersionState.LOCAL_PROJECT_MATCH VersionState.NO_RESOURCE VersionState.PROJECT_FILE_NEWER VersionState.VERSION_CONFLICT VersionState.VERSION_UNKNOWN	readonly	The Version Cue version state of the file.
viewPreferences	ViewPreference	readonly	View preference settings.
visible	Boolean	readonly	If true, the Document is visible.
windows	Windows Window	readonly	A collection of windows.
xmlComments	XMLComments XMLComment	readonly	A collection of XML comments.
xmlElements	XMLElements XMLElement	readonly	A collection of XML elements.
xmlExportMaps	XMLExportMaps XMLExportMap	readonly	A collection of XML export maps.
xmlExportPreferences	XMLExportPreference	readonly	XML export preference settings.
xmlImportMaps	XMLImportMaps XMLImportMap	readonly	A collection of XML import maps.
xmlImportPreferences	XMLImportPreference	readonly	XML import preference settings.
xmlInstructions	XMLInstructions XMLInstruction	readonly	A collection of XML instructions.
xmlItems	XMLItems XMLItem	readonly	A collection of XML items.
xmlPreferences	XMLPreference	readonly	The XML preference settings.
xmlTags	XMLTags XMLTag	readonly	A collection of XML tags.
xmlViewPreferences	XMLViewPreference	readonly	XML view preference settings.
zeroPoint	Array of Number Array of String	read/write	The ruler origin, specified as page coordinates in the format [x, y].

Method Listing

undefined autoStyle ()

Auto styles the document based on the tag-to-style map.

undefined autoTag ()

Auto tags the document based on the style-to-tag map.

undefined close ([saving:SaveOptions=SaveOptions], savingIn:File)

Closes the Document.

Parameter	Type	Description
saving	SaveOptions SaveOptions.ASK SaveOptions.NO SaveOptions.YES	The option for saving changes. (Optional) (default: SaveOptions.ASK)
savingIn	File	The file path of the saved document. Note: Required only when saving the document for the first time. If the document has previously been saved, specifying a path saves a copy and closes the original document. (Optional)

Parameter

Type

Description

saving

SaveOptions

SaveOptions.ASK

SaveOptions.NO

SaveOptions.YES

The option for saving changes. (Optional)

(default: SaveOptions.ASK)

savingIn

File

The file path of the saved document. Note: Required only when saving the document for the first time. If the document has previously been saved, specifying a path saves a copy and closes the original document. (Optional)

Story createTOC (using:TOCStyle, [replacing:Boolean=Boolean], fromBook:Book, placePoint:Array of Number String, [includeOverset:Boolean=Boolean], destinationLayer:Layer)

Creates a table of contents.

Parameter	Type	Description
using	TOCStyle	The TOC style to use to define the content, title, and format of the table of contents.
replacing	Boolean	If true, replaces the existing TOC. (Optional) (default: false)
fromBook	Book	The book whose documents to include in the TOC. (Optional)
placePoint	Array of Number Array of String	The point at which to place the TOC story, specified as page coordinates in the format [x, y]. (Optional)
includeOverset	Boolean	If true, includes overset text TOC entries in the TOC. (Optional) (default: false)
destinationLayer	Layer	The layer on which to place the TOC. (Optional)

undefined deleteUnusedTags ()

Deletes unused XML markup tags.

undefined exportFile (format:Varies ExportFormat String, to:File, [showingOptions:Boolean=Boolean], using:PDFExportPreset)

Exports the object(s) to a file.

Parameter	Type	Description
format	ExportFormat ExportFormat.EPS_TYPE ExportFormat.INCOPY ExportFormat.INCOPY_CS2_STORY ExportFormat.INDESIGN_INTERCHANGE ExportFormat.INDESIGN_SNIPPET ExportFormat.JPG ExportFormat.PDF_TYPE ExportFormat.RTF ExportFormat.SVG ExportFormat.SVG_COMPRESSED ExportFormat.TAGGED_TEXT ExportFormat.TEXT_TYPE ExportFormat.XML String	The export format. Can accept: ExportFormat enumerator or String.
to	File	The path of the export file.
showingOptions	Boolean	If true, prompts the user to select export options. (Optional) (default: false)
using	PDFExportPreset	The export style to use. (Optional)

String extractLabel (key:String)

Gets the label value associated with the specified key.

Parameter	Type	Description
key	String	The key.

Object getElements ()

Resolves the object specifier, creating an array of object references.

Color importAdobeSwatchbookProcessColor (name:String)

Imports a process color swatch from a preloaded Adobe color book.

Parameter	Type	Description
name	String	The process color to load.

Color importAdobeSwatchbookSpotColor (name:String)

Imports a spot color swatch from an Adobe color book.

Parameter	Type	Description
name	String	The spot color to load.

undefined importCellStyles (from:File, replaceOption:ReplaceOption)

Used to load cell styles from another document

Parameter	Type	Description
from	File	The file to load styles from
replaceOption	ReplaceOption ReplaceOption.OVERWRITE ReplaceOption.RENAME	overwrite, or rename

Parameter

Type

Description

from

File

The file to load styles from

replaceOption

ReplaceOption

ReplaceOption.OVERWRITE

ReplaceOption.RENAME

overwrite, or rename

undefined importDtd (from:File)

Imports a DTD to use for validation.

Parameter	Type	Description
from	File	The path to the DTD file.

undefined importStyles (format:ImportFormat, from:File, [globalStrategy:GlobalClashResolutionStrategy=GlobalClashResolutionStrategy])

Imports the specified styles.

Parameter	Type	Description
format	ImportFormat ImportFormat.CHARACTER_STYLES_FORMAT ImportFormat.OBJECT_STYLES_FORMAT ImportFormat.PARAGRAPH_STYLES_FORMAT ImportFormat.STROKE_STYLES_FORMAT ImportFormat.TEXT_STYLES_FORMAT ImportFormat.TOC_STYLES_FORMAT	The types of styles to import.
from	File	The file containing the styles you want to import.
globalStrategy	GlobalClashResolutionStrategy GlobalClashResolutionStrategy.DO_NOT_LOAD_THE_STYLE GlobalClashResolutionStrategy.LOAD_ALL_WITH_OVERWRITE GlobalClashResolutionStrategy.LOAD_ALL_WITH_RENAME	The resolution strategy to employ for imported styles that have the same names as existing styles. (Optional) (default: GlobalClashResolutionStrategy.LOAD_ALL_WITH_OVERWRITE)

Parameter

Type

Description

format

ImportFormat

ImportFormat.CHARACTER_STYLES_FORMAT

ImportFormat.OBJECT_STYLES_FORMAT

ImportFormat.PARAGRAPH_STYLES_FORMAT

ImportFormat.STROKE_STYLES_FORMAT

ImportFormat.TEXT_STYLES_FORMAT

ImportFormat.TOC_STYLES_FORMAT

The types of styles to import.

from

File

The file containing the styles you want to import.

globalStrategy

GlobalClashResolutionStrategy

GlobalClashResolutionStrategy.DO_NOT_LOAD_THE_STYLE

GlobalClashResolutionStrategy.LOAD_ALL_WITH_OVERWRITE

GlobalClashResolutionStrategy.LOAD_ALL_WITH_RENAME

The resolution strategy to employ for imported styles that have the same names as existing styles. (Optional)

(default: GlobalClashResolutionStrategy.LOAD_ALL_WITH_OVERWRITE)

undefined importTableStyles (from:File, replaceOption:ReplaceOption)

Used to load table styles from another document

Parameter	Type	Description
from	File	The file to load styles from
replaceOption	ReplaceOption ReplaceOption.OVERWRITE ReplaceOption.RENAME	overwrite, or rename

Parameter

Type

Description

from

File

The file to load styles from

replaceOption

ReplaceOption

ReplaceOption.OVERWRITE

ReplaceOption.RENAME

overwrite, or rename

undefined importXML (from:File)

Imports an XML file.

Parameter	Type	Description
from	File	The path to the XML file.

undefined insertLabel (key:String, value:String)

Sets the label to the value associated with the specified key.

Parameter	Type	Description
key	String	The key.
value	String	The value.

undefined loadSwatches (from:File)

Load swatches from the specified file.

Parameter	Type	Description
from	File	The swatch file or InDesign document.

undefined loadXMLTags (from:File)

Loads a set of XML markup tags from the specified file.

Parameter	Type	Description
from	File	The path to the file that contains the tags.

Boolean packageForGoLive (location:File, objects:Array of Varies Pages PageItems Texts)

Packages for GoLive

Parameter	Type	Description
location	File	File location for package
objects	Array of Pages Array of PageItems PageItem Array of Texts Text	Objects location for package. Can accept: Array of Pages, PageItems or Texts. (Optional)

Parameter

Type

Description

location

File

File location for package

objects

Array of Pages

Array of PageItems PageItem

Array of Texts Text

Objects location for package. Can accept: Array of Pages, PageItems or Texts. (Optional)

Boolean packageForPrint (to:File, copyingFonts:Boolean, copyingLinkedGraphics:Boolean, copyingProfiles:Boolean, updatingGraphics:Boolean, includingHiddenLayers:Boolean, ignorePreflightErrors:Boolean, creatingReport:Boolean)

Packages the document for handoff to a service provider.

Parameter	Type	Description
to	File	The folder, alias, or path in which to place the packaged files.
copyingFonts	Boolean	If true, copies fonts used in the document to the package folder.
copyingLinkedGraphics	Boolean	If true, copies linked graphics files to the package folder.
copyingProfiles	Boolean	If true, copies color profiles to the package folder.
updatingGraphics	Boolean	If true, updates graphics links to the package folder.
includingHiddenLayers	Boolean	If true, copies fonts and links from hidden layers to the package.
ignorePreflightErrors	Boolean	If true, ignores preflight errors and proceeds with the packaging. If false, cancels the packaging when errors exist.
creatingReport	Boolean	If true, creates a package report that includes printing instructions, print settings, lists of fonts, links and required inks, and other information.

undefined place (fileName:File, [showingOptions:Boolean=Boolean], withProperties:Object)

Place a file following the behavior of the place menu item

Parameter	Type	Description
fileName	File	The file to place
showingOptions	Boolean	Whether to display the import options dialog (Optional) (default: false)
withProperties	Object	Initial values for properties of the placed object(s) (Optional)

Parameter

Type

Description

fileName

File

The file to place

showingOptions

Boolean

Whether to display the import options dialog (Optional)

(default: false)

withProperties

Object

Initial values for properties of the placed object(s) (Optional)

undefined print (printDialog:Boolean, using:Varies PrinterPresetTypes PrinterPreset)

Prints the Document(s).

Parameter	Type	Description
printDialog	Boolean	Whether to invoke the print dialog (Optional)
using	PrinterPresetTypes PrinterPresetTypes.CUSTOM PrinterPresetTypes.DEFAULT_VALUE PrinterPreset	Printer preset to use. Can accept: PrinterPresetTypes enumerator or PrinterPreset. (Optional)

Parameter

Type

Description

printDialog

Boolean

Whether to invoke the print dialog (Optional)

using

PrinterPresetTypes

PrinterPresetTypes.CUSTOM

PrinterPresetTypes.DEFAULT_VALUE

PrinterPreset

Printer preset to use. Can accept: PrinterPresetTypes enumerator or PrinterPreset. (Optional)

undefined recompose ()

Recomposes the text in the Document.

undefined redefineCellStyle ()

Redefines a style based on the selection

undefined redefineTableStyle ()

Used to redefine a table style based on the selection

undefined redo ()

Redoes the last action.

undefined revertToProject ([forceRevert:Boolean=Boolean])

Reverts to the version of the document in Version Cue.

Parameter	Type	Description
forceRevert	Boolean	Forcibly reverts to the project version. (Optional) (default: false)

Parameter

Type

Description

forceRevert

Boolean

Forcibly reverts to the project version. (Optional)

(default: false)

Document save (to:File, [stationery:Boolean=Boolean])

Saves the document

Parameter	Type	Description
to	File	The file path of the saved document. Note: Required only if the document has not been previously saved. If the document has previously been saved, specifying a path saves a copy and closes the original document. (Optional)
stationery	Boolean	If true, saves the file as stationery (Mac OS) or as a template (Windows). Note: The file extension for stationery and templates is different than the extension for regular files. (Optional) (default: false)

Parameter

Type

Description

File

The file path of the saved document. Note: Required only if the document has not been previously saved. If the document has previously been saved, specifying a path saves a copy and closes the original document. (Optional)

stationery

Boolean

If true, saves the file as stationery (Mac OS) or as a template (Windows). Note: The file extension for stationery and templates is different than the extension for regular files. (Optional)

(default: false)

undefined saveAVersion (versionComments:String, [forceSave:Boolean=Boolean])

Saves a version to Version Cue.

Parameter	Type	Description
versionComments	String	The comments that describe the version. (Optional)
forceSave	Boolean	If true, forcibly saves the version. (Optional) (default: false)

Parameter

Type

Description

versionComments

String

The comments that describe the version. (Optional)

forceSave

Boolean

If true, forcibly saves the version. (Optional)

(default: false)

undefined saveSwatches (to:File, swatchList:Array of Swatch)

Saves the specified swatches to a file.

Parameter	Type	Description
to	File	The swatch file. Note: The format must be either .ase (Adobe Swatches Exchange) or a format native to the application that will use the file.
swatchList	Array of Swatch	The swatches to save.

undefined saveXMLTags (to:File)

Saves the XML markup tags as an XML file.

Parameter	Type	Description
to	File	The name and location of the XML file.

Text search (for:String, wholeWord:Boolean, caseSensitive:Boolean, replacingWith:String, withFindAttributes:Object, withChangeAttributes:Object)

Look for occurrences of text that matches specific criteria

Parameter	Type	Description
for	String	What to look for (Optional)
wholeWord	Boolean	If true, then disregard text embedded within a larger word (Optional)
caseSensitive	Boolean	If true, then search only for text that matches case (Optional)
replacingWith	String	What to replace the found text with, either a string or a special character (Optional)
withFindAttributes	Object	A record of find preference settings to use (Optional)
withChangeAttributes	Object	A record of change preference settings to use (Optional)

undefined select (selectableItems:Array of Varies Objects NothingEnum Object SelectAll, [existingSelection:SelectionOptions=SelectionOptions])

Selects the specified object(s).

Parameter	Type	Description
selectableItems	Array of Objects NothingEnum.NOTHING Object SelectAll SelectAll.ALL	The objects to select. Can accept: Object, Array of Objects, NothingEnum enumerator or SelectAll enumerator.
existingSelection	SelectionOptions SelectionOptions.ADD_TO SelectionOptions.REMOVE_FROM SelectionOptions.REPLACE_WITH	The selection status of the Document in relation to previously selected objects. (Optional) (default: SelectionOptions.REPLACE_WITH)

Parameter

Type

Description

selectableItems

Array of Objects

NothingEnum.NOTHING

Object

SelectAll

SelectAll.ALL

The objects to select. Can accept: Object, Array of Objects, NothingEnum enumerator or SelectAll enumerator.

existingSelection

SelectionOptions

SelectionOptions.ADD_TO

SelectionOptions.REMOVE_FROM

SelectionOptions.REPLACE_WITH

The selection status of the Document in relation to previously selected objects. (Optional)

(default: SelectionOptions.REPLACE_WITH)

VersionCueSyncStatus synchronizeWithVersionCue ([syncConflictResolution:SyncConflictResolution=SyncConflictResolution], versionComments:String)

Synchronizes the file with the Version Cue project.

Parameter	Type	Description
syncConflictResolution	SyncConflictResolution SyncConflictResolution.ASK_ABOUT_CONFLICTS SyncConflictResolution.PREFER_LOCAL SyncConflictResolution.PREFER_PROJECT SyncConflictResolution.SKIP_CONFLICTS	The conflict resolution method to use during synchronization. (Optional) (default: SyncConflictResolution.SKIP_CONFLICTS)
versionComments	String	The comments that describe the version. (Optional)

Parameter

Type

Description

syncConflictResolution

SyncConflictResolution

SyncConflictResolution.ASK_ABOUT_CONFLICTS

SyncConflictResolution.PREFER_LOCAL

SyncConflictResolution.PREFER_PROJECT

SyncConflictResolution.SKIP_CONFLICTS

The conflict resolution method to use during synchronization. (Optional)

(default: SyncConflictResolution.SKIP_CONFLICTS)

versionComments