GraphicStyle

app.activeDocument.graphicStyles[index

Description

A graphic style. Each graphic style defines a set of appearance attributes that you can apply non-destructively to page items. Graphic styles are contained in documents. Scripts cannot create new graphic styles.


Properties

GraphicStyle.name

app.activeDocument.graphicStyles[index].name

Description

The graphic style name.

Type

String.


GraphicStyle.parent

app.activeDocument.graphicStyles[index].parent

Description

The document that contains this graphic style.

Type

Document, read-only.


GraphicStyle.typename

app.activeDocument.graphicStyles[index].typename

Description

The class name of the referenced object.

Type

String, read-only.


Methods

GraphicStyle.applyTo()

app.activeDocument.graphicStyles[index].applyTo(artItem)

Description

Applies this art style to a specified art item.

Parameters

Parameter

Type

Description

artItem

PageItem

Target art item

Returns

Nothing.


GraphicStyle.mergeTo()

app.activeDocument.graphicStyles[index].mergeTo(artItem)

Description

Merges this art style into the current styles of a specified art item.

Parameters

Parameter

Type

Description

artItem

PageItem

Target art item

Returns

Nothing.


GraphicStyle.remove()

app.activeDocument.graphicStyles[index].remove()

Description

Deletes this object.

Returns

Nothing.


Example

Applying a graphic style

// Duplicates each path item in the selection, places the duplicate into a new group,
// then applies a graphic style to the new groups items

if (app.documents.length > 0) {
  var doc = app.activeDocument;
  var selected = doc.selection;
  var newGroup = doc.groupItems.add();
  newGroup.name = "NewGroup";
  newGroup.move(doc, ElementPlacement.PLACEATEND);

  var endIndex = selected.length;
  for (var i = 0; i < endIndex; i++) {
    if (selected[i].typename == "PathItem")
      selected[i].duplicate(newGroup, ElementPlacement.PLACEATEND);
  }

  for (i = 0; i < newGroup.pageItems.length; i++) {
    doc.graphicStyles[1].applyTo(newGroup.pageItems[i]);
  }
}