Application

The InDesign application

Go to Property Listing | Method Listing

Methods:

activate, cascadeWindows, copy, cut, deleteUnusedTags, doScript, exportPresets, importFile, importStyles, loadXMLTags, open, paste, pasteInPlace, pasteInto, print, quit, saveXMLTags, search, select, tileWindows

Objects:

Books, Boolean, ButtonPreference, ChangePreference, CharacterStyles, ClipboardPreference, ColorSetting, Colors, DashedStrokeStyles, DataMergeOption, Dialogs, DictionaryPreference, DisplayPerformancePreference, DisplaySettings, Document, DocumentPreference, DocumentPresets, Documents, DottedStrokeStyles, EPSExportPreference, EPSImportPreference, ExcelImportPreference, File, FindPreference, FlattenerPresets, Fonts, GalleyPreference, GeneralPreference, Gradients, GridPreference, GuidePreference, IMEPreference, ImageIOPreference, IndexOptions, Inks, JPEGExportPreference, LanguagesWithVendors, LayoutAdjustmentPreference, LayoutWindow, LayoutWindows, Libraries, Locale, MarginPreference, MixedInkGroups, MixedInks, NotePreference, NothingEnum, Number, Object, PDFExportPreference, PDFExportPresets, PDFPlacePreference, PackageForGoLivePreference, ParagraphStyles, PasteboardPreference, PolygonPreference, PrinterPresets, SVGExportPreference, ScriptPreference, SpellPreference, StoryExportPreference, StoryPreference, StoryWindow, StoryWindows, String, StripedStrokeStyles, StrokeStyles, Swatch, Swatches, TOCStyles, TaggedTextExportPreference, TaggedTextImportPreference, TextDefault, TextExportPreference, TextFramePreference, TextImportPreference, TextPreference, Tints, TransformPreference, TransparencyPreference, TrapPresets, UserDictionaries, UserInteractionLevels, ViewPreference, Window, Windows, WordRTFImportPreference, XMLExportMaps, XMLExportPreference, XMLImportMaps, XMLImportPreference, XMLTags, XMLViewPreference

Preferences:

ButtonPreference, ChangePreference, ClipboardPreference, DataMergeOption, DictionaryPreference, DisplayPerformancePreference, DocumentPreference, EPSExportPreference, EPSImportPreference, ExcelImportPreference, FindPreference, GalleyPreference, GeneralPreference, GridPreference, GuidePreference, IMEPreference, ImageIOPreference, IndexOptions, JPEGExportPreference, LayoutAdjustmentPreference, MarginPreference, NotePreference, PDFExportPreference, PDFPlacePreference, PackageForGoLivePreference, PasteboardPreference, PolygonPreference, SVGExportPreference, ScriptPreference, SpellPreference, StoryExportPreference, StoryPreference, TaggedTextExportPreference, TaggedTextImportPreference, TextExportPreference, TextFramePreference, TextImportPreference, TextPreference, TransformPreference, TransparencyPreference, ViewPreference, WordRTFImportPreference, XMLExportPreference, XMLImportPreference, XMLViewPreference

Property Listing

Property	Type	Access	Description
activeDocument	Document	read/write	The front-most document.
activeScript	File	readonly	The current script running from the Scripts panel.
activeWindow	LayoutWindow Window StoryWindow	read/write	The front-most window. Can return: Window, LayoutWindow or StoryWindow.
books	Books Book	readonly	A collection of books.
buttonPreferences	ButtonPreference	readonly	Button preference settings.
changePreferences	ChangePreference	read/write	The change preferences
characterStyles	CharacterStyles CharacterStyle	readonly	A collection of character styles.
clipboardPreferences	ClipboardPreference	readonly	Clipboard preference properties that define the way that the application interacts with the system clipboard.
colorSettings	ColorSetting	readonly	Color setting properties that define color management defaults.
colors	Colors Color	readonly	A collection of colors.
dashedStrokeStyles	DashedStrokeStyles DashedStrokeStyle	readonly	A collection of dashed stroke styles.
dataMergeOptions	DataMergeOption	readonly	The data merge option properties that define the data merge.
dialogs	Dialogs Dialog	readonly	A collection of dialogs.
dictionaryPreferences	DictionaryPreference	readonly	User dictionary preference settings.
displayPerformancePreferences	DisplayPerformancePreference	readonly	Display performance settings.
displaySettings	DisplaySettings DisplaySetting	readonly	Display setting properties.
documentPreferences	DocumentPreference	readonly	Document preference settings.
documentPresets	DocumentPresets DocumentPreset	readonly	A collection of document presets.
documents	Documents Document	readonly	A collection of documents.
dottedStrokeStyles	DottedStrokeStyles DottedStrokeStyle	readonly	A collection of dotted stroke styles.
epsExportPreferences	EPSExportPreference	readonly	EPS export preferences.
epsImportPreferences	EPSImportPreference	readonly	EPS import preferences.
excelImportPreferences	ExcelImportPreference	readonly	Excel import preferences.
filePath	File	readonly	The full path to the file.
findPreferences	FindPreference	read/write	The find preference properties that define default text or attribute searches.
flattenerPresets	FlattenerPresets FlattenerPreset	readonly	A collection of transparency flattener presets.
fonts	Fonts Font	readonly	A collection of fonts.
fullName	File	readonly	The full path to the Application, including the name of the Application.
galleyPreferences	GalleyPreference	readonly	Galley preference settings.
generalPreferences	GeneralPreference	readonly	General preference settings.
gradients	Gradients Gradient	readonly	A collection of gradients.
gridPreferences	GridPreference	readonly	Grid preference settings.
guidePreferences	GuidePreference	readonly	Guide preference settings.
imageIOPreferences	ImageIOPreference	readonly	The image I/O preference properties that define preferences for importing images.
imePreferences	IMEPreference	readonly	IME preference settings.
indexGenerationOptions	IndexOptions	readonly	The index options properties that define how an index is formatted.
inks	Inks Ink	readonly	A collection of inks.
jpegExportPreferences	JPEGExportPreference	readonly	JPEG export preferences.
languagesWithVendors	LanguagesWithVendors	readonly	A collection of languages with vendors.
layoutAdjustmentPreferences	LayoutAdjustmentPreference	readonly	Layout sdjustment preference settings.
layoutWindows	LayoutWindows LayoutWindow	readonly	A collection of layout windows.
libraries	Libraries Library	readonly	A collection of libraries.
locale	Locale Locale.DANISH_LOCALE Locale.ENGLISH_LOCALE Locale.FINNISH_LOCALE Locale.FRENCH_LOCALE Locale.GERMAN_LOCALE Locale.INTERNATIONAL_ENGLISH_LOCALE Locale.ITALIAN_LOCALE Locale.JAPANESE_LOCALE Locale.PORTUGUESE_LOCALE Locale.SPANISH_LOCALE Locale.SWEDISH_LOCALE	readonly	The locale of the application.
marginPreferences	MarginPreference	readonly	Margin preference settings.
mixedInkGroups	MixedInkGroups MixedInkGroup	readonly	A collection of mixed ink groups.
mixedInks	MixedInks MixedInk	readonly	A collection of mixed inks.
name	String	readonly	The name of the Application.
notePreferences	NotePreference	readonly	Note preference settings.
packageForGoLivePreferences	PackageForGoLivePreference	readonly	The Package For GoLive preference properties that define how a document is packaged for GoLive.
palettesVisible	Boolean	read/write	If true, displays the palettes.
paragraphStyles	ParagraphStyles ParagraphStyle	readonly	A collection of paragraph styles.
parent	Application	readonly	The parent of the Application (a Application).
pasteboardPreferences	PasteboardPreference	readonly	Pasteboard preference settings.
pdfExportPreferences	PDFExportPreference	readonly	A collection of PDF export preferences.
pdfExportPresets	PDFExportPresets PDFExportPreset	readonly	A collection of PDF export presets.
pdfPlacePreferences	PDFPlacePreference	readonly	The PDF place preference properties that define how PDF files are placed in the current document.
polygonPreferences	PolygonPreference	readonly	Polygon preference properties to use to define default settings for creating a polygon.
printerPresets	PrinterPresets PrinterPreset	readonly	A collection of printer presets.
properties	Object	read/write	A property that allows setting of several properties at the same time.
scriptPreferences	ScriptPreference	readonly	Script preferences.
selection	Array of Objects Object NothingEnum.NOTHING	read/write	The selection. Can return: Object, Array of Objects or NothingEnum enumerator.
spellPreferences	SpellPreference	readonly	Spell-check preferences.
storyExportPreferences	StoryExportPreference	readonly	Story export preference settings.
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.
svgExportPreferences	SVGExportPreference	readonly	SVG export preferences.
swatches	Swatches	readonly	A collection of swatches.
taggedTextExportPreferences	TaggedTextExportPreference	readonly	Tagged text export preferences.
taggedTextImportPreferences	TaggedTextImportPreference	readonly	Tagged text import preferences.
textDefaults	TextDefault	readonly	Text default settings.
textExportPreferences	TextExportPreference	readonly	Text export preferences.
textFramePreferences	TextFramePreference	readonly	Text frame preference settings.
textImportPreferences	TextImportPreference	readonly	Text import preferences.
textPreferences	TextPreference	readonly	Text preference settings.
tints	Tints Tint	readonly	A collection of tints.
tocStyles	TOCStyles TOCStyle	readonly	A collection of TOC styles.
transformPreferences	TransformPreference	readonly	Transform preference properties that define default behaviors when transforming objects. Note: Transforming includes rotation, scaling, flipping, and shearing.
transparencyPreferences	TransparencyPreference	readonly	Transparency preference settings.
trapPresets	TrapPresets TrapPreset	readonly	A collection of trap presets.
unusedSwatches	Array of Swatch	readonly	The swatches that are not being used.
userDictionaries	UserDictionaries UserDictionary	readonly	A collection of user dictionaries.
userInteractionLevel	UserInteractionLevels UserInteractionLevels.INTERACT_WITH_ALL UserInteractionLevels.INTERACT_WITH_LOCAL UserInteractionLevels.INTERACT_WITH_SELF UserInteractionLevels.NEVER_INTERACT	read/write	Controls the display of dialogs and alerts during script processing.
userName	String	read/write	The user associated with the tracked changes and notes.
version	Number	readonly	Version of the application
viewPreferences	ViewPreference	readonly	View preference settings.
visible	Boolean	readonly	If true, the Application is visible.
windows	Windows Window	readonly	A collection of windows.
wordRTFImportPreferences	WordRTFImportPreference	readonly	Word and RTF import preferences.
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.
xmlTags	XMLTags XMLTag	readonly	A collection of XML tags.
xmlViewPreferences	XMLViewPreference	readonly	XML view preference settings.

Method Listing

undefined activate ()

Makes the application the front-most or active window.

undefined cascadeWindows ()

Cascades all document windows.

undefined copy ()

Copies the selection in the active document window to the clipboard.

undefined cut ()

Cuts the selection in the active document window and stores it in the clipboard.

undefined deleteUnusedTags ()

Deletes unused XML markup tags.

undefined doScript (script:Varies File String, [language:ScriptLanguage=ScriptLanguage])

Run a script in a specific language

Parameter	Type	Description
script	File String	The script to execute. Can accept: File or String.
language	ScriptLanguage ScriptLanguage.UNKNOWN ScriptLanguage.JAVASCRIPT ScriptLanguage.UXPSCRIPT ScriptLanguage.APPLESCRIPT_LANGUAGE ScriptLanguage.APPLESCRIPT_LANGUAGE	The language of the script to execute. If not specified, the language used to call this method is used. (Optional) (default: ScriptLanguage.UNKNOWN)

Parameter

Type

Description

script

File

String

The script to execute. Can accept: File or String.

language

ScriptLanguage

ScriptLanguage.UNKNOWN

ScriptLanguage.JAVASCRIPT

ScriptLanguage.UXPSCRIPT

ScriptLanguage.APPLESCRIPT_LANGUAGE

The language of the script to execute. If not specified, the language used to call this method is used. (Optional)

(default: ScriptLanguage.UNKNOWN)

undefined exportPresets (format:ExportPresetFormat, to:File)

Export the file's presets to the specified file.

Parameter	Type	Description
format	ExportPresetFormat ExportPresetFormat.DOCUMENT_PRESETS_FORMAT ExportPresetFormat.FLATTENER_PRESETS_FORMAT ExportPresetFormat.PDF_EXPORT_PRESETS_FORMAT ExportPresetFormat.PRINTER_PRESETS_FORMAT	The type of preset to export.
to	File	The file to export the presets to.

Parameter

Type

Description

format

ExportPresetFormat

ExportPresetFormat.DOCUMENT_PRESETS_FORMAT

ExportPresetFormat.FLATTENER_PRESETS_FORMAT

ExportPresetFormat.PDF_EXPORT_PRESETS_FORMAT

ExportPresetFormat.PRINTER_PRESETS_FORMAT

The type of preset to export.

File

The file to export the presets to.

undefined importFile (format:ExportPresetFormat, from:File)

Imports presets from the specified file.

Parameter	Type	Description
format	ExportPresetFormat ExportPresetFormat.DOCUMENT_PRESETS_FORMAT ExportPresetFormat.FLATTENER_PRESETS_FORMAT ExportPresetFormat.PDF_EXPORT_PRESETS_FORMAT ExportPresetFormat.PRINTER_PRESETS_FORMAT	The type of preset to import.
from	File	The file to import presets from.

Parameter

Type

Description

format

ExportPresetFormat

ExportPresetFormat.DOCUMENT_PRESETS_FORMAT

ExportPresetFormat.FLATTENER_PRESETS_FORMAT

ExportPresetFormat.PDF_EXPORT_PRESETS_FORMAT

ExportPresetFormat.PRINTER_PRESETS_FORMAT

The type of preset to import.

from

File

The file to import presets from.

undefined importStyles (format:ImportFormat, from:File)

Import styles.

Parameter	Type	Description
format	ImportFormat ImportFormat.CHARACTER_STYLES_FORMAT ImportFormat.PARAGRAPH_STYLES_FORMAT ImportFormat.TEXT_STYLES_FORMAT ImportFormat.TOC_STYLES_FORMAT	The type of styles to import.
from	File	an InDesign file to import from

Parameter

Type

Description

format

ImportFormat

ImportFormat.CHARACTER_STYLES_FORMAT

ImportFormat.PARAGRAPH_STYLES_FORMAT

ImportFormat.TEXT_STYLES_FORMAT

ImportFormat.TOC_STYLES_FORMAT

The type of styles to import.

from

File

an InDesign file to import from

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.

Varies open (from:Array of Varies File Files., [showingWindow:Boolean=Boolean])

Opens a document, book, or library.

Parameter	Type	Description
from	File Array of Files.	The file path to the file to open. Can accept: File or Array of Files.
showingWindow	Boolean	If true, opens the document in a window. If false, the document is opened but is not displayed in a window. (Optional) (default: true)

Parameter

Type

Description

from

File

Array of Files.

The file path to the file to open. Can accept: File or Array of Files.

showingWindow

Boolean

If true, opens the document in a window. If false, the document is opened but is not displayed in a window. (Optional)

(default: true)

undefined paste ()

Pastes data from the clipboard into the active document window.

undefined pasteInPlace ()

Pastes data from the clipboard into the active document window at the same position that the data held in its original document.

undefined pasteInto ()

Pastes data from the clipboard into the selected object in the active document window.

undefined print (from:Array of Varies File Files., printDialog:Boolean, using:Varies PrinterPresetTypes PrinterPreset)

Prints the specified file(s).

Parameter	Type	Description
from	File Array of Files.	One or more file paths. Can accept: File or Array of Files.
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

from

File

Array of Files.

One or more file paths. Can accept: File or Array of Files.

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 quit ([saving:SaveOptions=SaveOptions])

Quits the application.

Parameter	Type	Description
saving	SaveOptions SaveOptions.ASK SaveOptions.NO SaveOptions.YES	The option to use for saving changes to open documents before quitting. (Optional) (default: SaveOptions.ASK)

Parameter

Type

Description

saving

SaveOptions

SaveOptions.ASK

SaveOptions.NO

SaveOptions.YES

The option to use for saving changes to open documents before quitting. (Optional)

(default: SaveOptions.ASK)

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 Object NothingEnum, [existingSelection:SelectionOptions=SelectionOptions])

Select one or more objects.

Parameter	Type	Description
selectableItems	Array of Objects Object NothingEnum.NOTHING	The object(s) to select. Can accept: Object, Array of Objects or NothingEnum enumerator.
existingSelection	SelectionOptions SelectionOptions.ADD_TO SelectionOptions.REMOVE_FROM SelectionOptions.REPLACE	How to handle the existing selection (Optional) (default: SelectionOptions.REPLACE)

Parameter

Type

Description

selectableItems

Array of Objects

Object

NothingEnum.NOTHING

The object(s) to select. Can accept: Object, Array of Objects or NothingEnum enumerator.

existingSelection

SelectionOptions

SelectionOptions.ADD_TO

SelectionOptions.REMOVE_FROM