InDesign2026
API 21.5.1.73
Object

ColorSetting

Color management settings.

Preference ColorSetting
Hierarchy

Application

ColorSetting

Properties

NameType AccessDescription
Boolean read/write If true, uses LAB alternates for spot colors when available.
String read/write The current color management system settings configuration. Note: For information on possible values, see CMS settings list.
String[] readonly A list of valid color management system settings configurations.
File read/write The file path of the CSF file to use.
ColorSettingsPolicy
read/write The policy for handling colors in a CMYK color model, including reading and embedding color profiles, resolving mismatches between embedded color profiles and the working space, and moving colors between documents.
Boolean read/write If true, enables color management.
String read/write The color management module (CMM) for mapping color space gamuts between documents.
String[] readonly The available color engines.
EventListeners<EventListener> readonly A collection of event listeners.
Events<Event> readonly A collection of events.
Boolean read/write If true, uses idealized black for CMYK-to-RGB or CMYK-to-Gray conversions to print or export.
Boolean read/write If true, uses idealized black for CMYK-to-RGB or CMYK-to-Gray conversions to the screen.
DefaultRenderingIntent
read/write The default rendering intent.
Boolean readonly Returns true if the object specifier resolves to valid objects.
Boolean read/write If true, displays a prompt when opening a file whose embedded color profile does not match the current working space. The prompt provides the option to override the default mismatch behavior.
Boolean read/write If true, displays a prompt when importing an object (via pasting, drag-and-drop, or other similar methods) whose colors do not match the current working space. The prompt provides the option to override the default mismatch behavior.
Boolean read/write If true, displays a prompt when opening a file that does not have an embedded color profile. The prompt provides the option to assign a color profile.
Application readonly The parent of the ColorSetting (a Application).
Object read/write A property that allows setting of several properties at the same time.
ColorSettingsPolicy
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.
Boolean read/write If true, uses black point compensation to ensure that shadow detail is preserved by simulating the full dynamic range of the output device.
String read/write The current CMYK profile.
String[] readonly A list of valid CMYK color profiles.
String read/write The current RGB profile.
String[] readonly A list of valid RGB color profiles.

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.
ColorSetting[]

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

String

Retrieves the object specifier.

Object of 4

Properties elsewhere that hold a ColorSetting.

Return 1

Methods that return a ColorSetting.