GraphicStyle

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]);
 }
}