GraphItems

GraphItems

app.activeDocument.graphItems

Description

A collection GraphItem objects, which gives you access to all the graph art items in an Illustrator document.

---

Properties

GraphItems.length

app.activeDocument.graphItems.length

Description

The number of objects in the collection.

Type

Number; read-only.

---

GraphItems.parent

app.activeDocument.graphItems.parent

Description

The parent of this object.

Type

Object; read-only.

---

GraphItems.typename

app.activeDocument.graphItems.typename

Description

The class name of the referenced object.

Type

String; read-only.

---

Methods

GraphItems.getByName()

app.activeDocument.graphItems.getByName(name)

Description

Gets the first element in the collection with the specified name.

Parameters

Parameter	Type	Description
name	String	Name of element to get

Returns

GraphItems

---

GraphItems.index()

app.activeDocument.graphItems.index(itemKey)

Description

Gets an element from the collection.

Parameters

Parameter	Type	Description
itemKey	String, Number	String or number key

Returns

GraphItem

---

GraphItems.removeAll()

app.activeDocument.graphItems.removeAll()

Description

Deletes all elements in the collection.

Returns

Nothing.

---

Example

Rotating graph items

// Rotates each graph item in the current document 90 degrees.

// Verify a document with a graph item is open
var ok = false;

if (documents.length > 0) {
 var docRef = activeDocument;
 var iCount = docRef.graphItems.length;
 if (iCount > 0) {
 ok = true;
 for (var i = 0; i < iCount; i++) {
 var graphRef = docRef.graphItems[i];
 graphRef.selected = true;
 graphRef.rotate(90); //rotate clockwise 90 degrees
 }
 redraw();
 }
}