Adobe InDesign CS2 (4.0) Object Model JS: Swatch

InDesign CS2

previous page next page

Class

Swatch

A swatch (color, gradient, tint, or mixed ink).

Superclass of Color, Gradient, MixedInk, and MixedInkGroup

QuickLinks

duplicate, extractLabel, getElements, insertLabel, merge, remove, toSource, toSpecifier

Hierarchy

Application | Document

Swatch

Color | Gradient | MixedInk | MixedInkGroup

Properties

Property	Type	Access	Description
id	number	readonly	The unique ID of the Swatch.
index	number	readonly	The index of the Swatch within its containing object.
label	string	r/w	A property that can be set to any string.
name	string	r/w	The name of the Swatch.
parent	Application Document	readonly	The parent of the Swatch (a Application or Document).
properties	Object	r/w	A property that allows setting of several properties at the same time.

Methods

Instances

Swatch duplicate ()
Duplicates the Swatch.

string extractLabel (key: string)
Gets the label value associated with the specified key.

Parameter	Type	Description
key	string	The key.

Array of Object getElements ()
Resolves the object specifier, creating an array of object references.

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

Swatch merge (with: any)
Merges the specified swatches with the swatch.

Parameter	Type	Description
with	Array of Swatches String Swatch	The swatches to merge. Can accept: Array of Swatches, Swatch or String.

void remove ([replacingWith: Swatch])
Deletes the swatch.

Parameter	Type	Description
replacingWith	Swatch	The swatch to apply in place of the deleted swatch. (Optional)

string toSource ()
Generates a string which, if executed, will return the Swatch.

string toSpecifier ()
Retrieves the object specifier.

Element of

Application.unusedSwatches

Button.fillColor

Button.gapColor

Button.shadowColor

Button.strokeColor

Cell.bottomEdgeStrokeColor

Cell.bottomEdgeStrokeGapColor

Cell.diagonalLineStrokeColor

Cell.diagonalLineStrokeGapColor

Cell.fillColor

Cell.innerColumnStrokeColor

Cell.innerColumnStrokeGapColor

Cell.innerRowStrokeColor

Cell.innerRowStrokeGapColor

Cell.leftEdgeStrokeColor

Cell.leftEdgeStrokeGapColor

Cell.rightEdgeStrokeColor

Cell.rightEdgeStrokeGapColor

Cell.topEdgeStrokeColor

Cell.topEdgeStrokeGapColor

CellStyle.bottomEdgeStrokeColor

CellStyle.bottomEdgeStrokeGapColor

CellStyle.diagonalLineStrokeColor

CellStyle.diagonalLineStrokeGapColor

CellStyle.fillColor

CellStyle.leftEdgeStrokeColor

CellStyle.leftEdgeStrokeGapColor

CellStyle.rightEdgeStrokeColor

CellStyle.rightEdgeStrokeGapColor

CellStyle.topEdgeStrokeColor

CellStyle.topEdgeStrokeGapColor

ChangePreference.bulletsAndNumberingColor

ChangePreference.fillColor

ChangePreference.strikeThroughColor

ChangePreference.strikeThroughGapColor

ChangePreference.strokeColor

ChangePreference.underlineColor

ChangePreference.underlineGapColor

Character.bulletsAndNumberingColor

Character.fillColor

Character.ruleAboveColor

Character.ruleAboveGapColor

Character.ruleBelowColor

Character.ruleBelowGapColor

Character.strikeThroughColor

Character.strikeThroughGapColor

Character.strokeColor

Character.underlineColor

Character.underlineGapColor

CharacterStyle.fillColor

CharacterStyle.strikeThroughColor

CharacterStyle.strikeThroughGapColor

CharacterStyle.strokeColor

CharacterStyle.underlineColor

CharacterStyle.underlineGapColor

Column.bottomEdgeStrokeColor

Column.bottomEdgeStrokeGapColor

Column.diagonalLineStrokeColor

Column.diagonalLineStrokeGapColor

Column.fillColor

Column.innerColumnStrokeColor

Column.innerColumnStrokeGapColor

Column.innerRowStrokeColor

Column.innerRowStrokeGapColor

Column.leftEdgeStrokeColor

Column.leftEdgeStrokeGapColor

Column.rightEdgeStrokeColor

Column.rightEdgeStrokeGapColor

Column.topEdgeStrokeColor

Column.topEdgeStrokeGapColor

Document.unusedSwatches

EPS.shadowColor

FindPreference.bulletsAndNumberingColor

FindPreference.fillColor

FindPreference.strikeThroughColor

FindPreference.strikeThroughGapColor

FindPreference.strokeColor

FindPreference.underlineColor

FindPreference.underlineGapColor

FootnoteOption.continuingRuleColor

FootnoteOption.continuingRuleGapColor

FootnoteOption.ruleColor

FootnoteOption.ruleGapColor

FormField.fillColor

FormField.gapColor

FormField.shadowColor

FormField.strokeColor

GraphicLine.fillColor

GraphicLine.gapColor

GraphicLine.shadowColor

GraphicLine.strokeColor

Group.fillColor

Group.gapColor

Group.shadowColor

Group.strokeColor

Image.fillColor

Image.shadowColor

InsertionPoint.bulletsAndNumberingColor

InsertionPoint.fillColor

InsertionPoint.ruleAboveColor

InsertionPoint.ruleAboveGapColor

InsertionPoint.ruleBelowColor

InsertionPoint.ruleBelowGapColor

InsertionPoint.strikeThroughColor

InsertionPoint.strikeThroughGapColor

InsertionPoint.strokeColor

InsertionPoint.underlineColor

InsertionPoint.underlineGapColor

Line.bulletsAndNumberingColor

Line.fillColor

Line.ruleAboveColor

Line.ruleAboveGapColor

Line.ruleBelowColor

Line.ruleBelowGapColor

Line.strikeThroughColor

Line.strikeThroughGapColor

Line.strokeColor

Line.underlineColor

Line.underlineGapColor

ObjectStyle.fillColor

ObjectStyle.gapColor

ObjectStyle.shadowColor

ObjectStyle.strokeColor

Oval.fillColor

Oval.gapColor

Oval.shadowColor

Oval.strokeColor

PDF.shadowColor

PICT.shadowColor

PageItem.fillColor

PageItem.gapColor

PageItem.shadowColor

PageItem.strokeColor

Paragraph.bulletsAndNumberingColor

Paragraph.fillColor

Paragraph.ruleAboveColor

Paragraph.ruleAboveGapColor

Paragraph.ruleBelowColor

Paragraph.ruleBelowGapColor

Paragraph.strikeThroughColor

Paragraph.strikeThroughGapColor

Paragraph.strokeColor

Paragraph.underlineColor

Paragraph.underlineGapColor

ParagraphStyle.bulletsAndNumberingColor

ParagraphStyle.fillColor

ParagraphStyle.ruleAboveColor

ParagraphStyle.ruleAboveGapColor

ParagraphStyle.ruleBelowColor

ParagraphStyle.ruleBelowGapColor

ParagraphStyle.strikeThroughColor

ParagraphStyle.strikeThroughGapColor

ParagraphStyle.strokeColor

ParagraphStyle.underlineColor

ParagraphStyle.underlineGapColor

Polygon.fillColor

Polygon.gapColor

Polygon.shadowColor

Polygon.strokeColor

Rectangle.fillColor

Rectangle.gapColor

Rectangle.shadowColor

Rectangle.strokeColor

Row.bottomEdgeStrokeColor

Row.bottomEdgeStrokeGapColor

Row.diagonalLineStrokeColor

Row.diagonalLineStrokeGapColor

Row.fillColor

Row.innerColumnStrokeColor

Row.innerColumnStrokeGapColor

Row.innerRowStrokeColor

Row.innerRowStrokeGapColor

Row.leftEdgeStrokeColor

Row.leftEdgeStrokeGapColor

Row.rightEdgeStrokeColor

Row.rightEdgeStrokeGapColor

Row.topEdgeStrokeColor

Row.topEdgeStrokeGapColor

Story.bulletsAndNumberingColor

Story.fillColor

Story.ruleAboveColor

Story.ruleAboveGapColor

Story.ruleBelowColor

Story.ruleBelowGapColor

Story.strikeThroughColor

Story.strikeThroughGapColor

Story.strokeColor

Story.underlineColor

Story.underlineGapColor

Table.bottomBorderStrokeColor

Table.bottomBorderStrokeGapColor

Table.endColumnFillColor

Table.endColumnStrokeColor

Table.endColumnStrokeGapColor

Table.endRowFillColor

Table.endRowStrokeColor

Table.endRowStrokeGapColor

Table.leftBorderStrokeColor

Table.leftBorderStrokeGapColor

Table.rightBorderStrokeColor

Table.rightBorderStrokeGapColor

Table.startColumnFillColor

Table.startColumnStrokeColor

Table.startColumnStrokeGapColor

Table.startRowFillColor

Table.startRowStrokeColor

Table.startRowStrokeGapColor

Table.topBorderStrokeColor

Table.topBorderStrokeGapColor

TableStyle.bottomBorderStrokeColor

TableStyle.bottomBorderStrokeGapColor

TableStyle.endColumnFillColor

TableStyle.endColumnStrokeColor

TableStyle.endColumnStrokeGapColor

TableStyle.endRowFillColor

TableStyle.endRowStrokeColor

TableStyle.endRowStrokeGapColor

TableStyle.leftBorderStrokeColor

TableStyle.leftBorderStrokeGapColor

TableStyle.rightBorderStrokeColor

TableStyle.rightBorderStrokeGapColor

TableStyle.startColumnFillColor

TableStyle.startColumnStrokeColor

TableStyle.startColumnStrokeGapColor

TableStyle.startRowFillColor

TableStyle.startRowStrokeColor

TableStyle.startRowStrokeGapColor

TableStyle.topBorderStrokeColor

TableStyle.topBorderStrokeGapColor

Text.bulletsAndNumberingColor

Text.fillColor

Text.ruleAboveColor

Text.ruleAboveGapColor

Text.ruleBelowColor

Text.ruleBelowGapColor

Text.strikeThroughColor

Text.strikeThroughGapColor

Text.strokeColor

Text.underlineColor

Text.underlineGapColor

TextColumn.bulletsAndNumberingColor

TextColumn.fillColor

TextColumn.ruleAboveColor

TextColumn.ruleAboveGapColor

TextColumn.ruleBelowColor

TextColumn.ruleBelowGapColor

TextColumn.strikeThroughColor

TextColumn.strikeThroughGapColor

TextColumn.strokeColor

TextColumn.underlineColor

TextColumn.underlineGapColor

TextDefault.bulletsAndNumberingColor

TextDefault.fillColor

TextDefault.ruleAboveColor

TextDefault.ruleAboveGapColor

TextDefault.ruleBelowColor

TextDefault.ruleBelowGapColor

TextDefault.strikeThroughColor

TextDefault.strikeThroughGapColor

TextDefault.strokeColor

TextDefault.underlineColor

TextDefault.underlineGapColor

TextFrame.fillColor

TextFrame.gapColor

TextFrame.shadowColor

TextFrame.strokeColor

TextStyleRange.bulletsAndNumberingColor

TextStyleRange.fillColor

TextStyleRange.ruleAboveColor

TextStyleRange.ruleAboveGapColor

TextStyleRange.ruleBelowColor

TextStyleRange.ruleBelowGapColor

TextStyleRange.strikeThroughColor

TextStyleRange.strikeThroughGapColor

TextStyleRange.strokeColor

TextStyleRange.underlineColor

TextStyleRange.underlineGapColor

WMF.shadowColor

Word.bulletsAndNumberingColor

Word.fillColor

Word.ruleAboveColor

Word.ruleAboveGapColor

Word.ruleBelowColor

Word.ruleBelowGapColor

Word.strikeThroughColor

Word.strikeThroughGapColor

Word.strokeColor

Word.underlineColor

Word.underlineGapColor

Used in:

void Application.saveSwatches (to: File, swatchList: Array of Swatch)

void Character.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Character.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

Swatch Color.merge (with: any)

void Color.remove ([replacingWith: Swatch])

void Document.saveSwatches (to: File, swatchList: Array of Swatch)

Swatch Gradient.merge (with: any)

void Gradient.remove ([replacingWith: Swatch])

void InsertionPoint.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void InsertionPoint.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Line.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Line.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

Swatch MixedInk.merge (with: any)

void MixedInk.remove ([replacingWith: Swatch])

Swatch MixedInkGroup.merge (with: any)

void MixedInkGroup.remove ([replacingWith: Swatch])

void Paragraph.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Paragraph.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Story.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Story.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

Swatch Swatch.merge (with: any)

void Swatch.remove ([replacingWith: Swatch])

array of Swatch Swatches.itemByRange (from: any, to: any)

Swatch Swatches.nextItem (obj: Swatch)

Swatch Swatches.previousItem (obj: Swatch)

void Text.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Text.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void TextColumn.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void TextColumn.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void TextStyleRange.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void TextStyleRange.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

Swatch Tint.merge (with: any)

void Tint.remove ([replacingWith: Swatch])

void Word.applyBullets ([bulletChar: number][, bulletType: BulletCharacterType][, bulletFont: any][, bulletFontStyle: string][, bulletSize: number][, bulletColor: Swatch][, bulletAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])

void Word.applyNumbers ([numberingStyle: NumberingStyle][, numberingSeparator: number][, startingValue: number][, numberFont: any][, numberFontStyle: string][, numberSize: number][, numberColor: Swatch][, numberAlignment: ListAlignment=ListAlignment.HANGING_LIST][, listLeftIndent: number][, listFirstLineIndent: number][, listFirstTabPosition: number])