InDesign2026
API 21.5.1.73
Object

ScriptPreference

Scripting environment preferences.

Preference ScriptPreference
Hierarchy

Application

ScriptPreference

Properties

NameType AccessDescription
Boolean read/write If true, enables redraw during script execution.
EventListeners<EventListener> readonly A collection of event listeners.
Events<Event> readonly A collection of events.
Boolean readonly Returns true if the object specifier resolves to valid objects.
AutoEnum | MeasurementUnits
read/write The measurement unit used during script processing. Can return: AutoEnum enumerator or MeasurementUnits enumerator.
Application readonly The parent of the ScriptPreference (a Application).
Object read/write A property that allows setting of several properties at the same time.
Folder readonly The path to the Scripts folder for the application.
2 Strings[] | Files[] readonly A list of the scripts in the Scripts folder. Can return: Array of Array of 2 Strings or Files.
UserInteractionLevels
read/write Controls the display of dialogs and alerts during script processing.
String | Real read/write The version of the scripting environment. Can also accept: Real.

Methods

EventListener

Adds an event listener.

eventType String The event type.
handler File | JavaScriptFunction The event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
ScriptPreference[]

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

Boolean

Removes the event listener.

eventType String The registered event type.
handler File | JavaScriptFunction The registered event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
String

Generates a string which, if executed, will return the ScriptPreference.

String

Retrieves the object specifier.

Object of 4

Properties elsewhere that hold a ScriptPreference.

Return 1

Methods that return a ScriptPreference.