OpenOptions

openOptions

Description

Options for opening a document, used with the Application.open() method.

Properties

OpenOptions.convertCropAreaToArboard

openOptions.convertCropAreaToArboard

Description

Optional. Convert crop areas to artboards when opening a legacy document in Illustrator CS4 or later. When false, crop areas are discarded.

Default: true.

Type

Boolean.

OpenOptions.convertTilesToArboard

openOptions.convertTilesToArboard

Description

Optional. Convert print tiles to artboards when opening a legacy document in Illustrator CS4 or later.

Default: false.

Type

Boolean.

OpenOptions.createArtboardWithArtworkBoundingBox

openOptions.createArtboardWithArtworkBoundingBox

Description

Optional. Create an artboard with the dimensions of the bounding box of the artwork when opening a legacy document in Illustrator CS4 or later.

Default: false.

Type

Boolean.

OpenOptions.openAs

openOptions.openAs

Description

Optional. Open the file as an Illustrator library of this type.

Default: LibraryType.IllustratorArtwork.

Type

LibraryType

OpenOptions.preserveLegacyArtboard

openOptions.preserveLegacyArtboard

Description

Optional. Preserve legacy artboards when opening a legacy document in Illustrator CS4 or later.

Default: true.

Type

Boolean.

OpenOptions.updateLegacyGradientMesh

openOptions.updateLegacyGradientMesh

Description

If true, preserves the spot colors in the gradient mesh objects for legacy documents (pre-Illustrator CS4).

Default: true.

Type

Boolean.

OpenOptions.updateLegacyText

openOptions.updateLegacyText

Description

Optional. If true, update all legacy text items (from previous versions of Illustrator).

Default: false.

Type

Boolean.

Example

Automatically updating legacy text on open

// Opens a file with legacy text (AI 10 or older), using
// OpenOptions to automatically update the legacy text.

var fileRef = filePath;
if (fileRef != null) {
    var openOptions = new OpenOptions();
    openOptions.updateLegacyText = true;

    var docRef = open(fileRef, DocumentColorSpace.RGB, openOptions);
}