PageItems

PageItems

app.activeDocument.pageItems

Description

A collection of PageItem objects. Provides complete access to all the art items in an Illustrator document in the following classes:

• CompoundPathItem
  • Properties
  • Methods
  • Example
• GraphItem
  • Properties
  • Methods
• GroupItem
  • Properties
  • Methods
  • Example
• LegacyTextItem
  • Properties
  • Methods
• MeshItem
  • Properties
  • Methods
  • Example
• NonNativeItem
  • Properties
  • Methods
• PathItem
  • Properties
  • Methods
  • Example
• PlacedItem
  • Properties
  • Methods
  • Example
• PluginItem
  • Properties
  • Methods
  • Example
• RasterItem
  • Properties
  • Methods
• SymbolItem
  • Properties
  • Methods
• TextFrameItem
  • Properties
  • Methods
  • Example

You can reference page items through the PageItems property in a Document, Layer, or GroupItem.

When you access an individual item in one of these collections, the reference is a page item of one of a particular type. For example, if you use PageItems to reference a graph item, the typename value of that object is GraphItem.

---

Properties

PageItems.length

app.activeDocument.pageItems.length

Description

The number of objects in the collection.

Type

Number; read-only.

---

PageItems.parent

app.activeDocument.pageItems.parent

Description

The parent of this object.

Type

Object; read-only.

---

PageItems.typename

app.activeDocument.pageItems.typename

Description

The class name of the referenced object.

Type

String; read-only.

---

Methods

PageItems.getByName()

app.activeDocument.pageItems.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

PageItem

---

PageItems.index()

app.activeDocument.pageItems.index(itemKey)

Description

Gets an element from the collection.

Parameters

Parameter	Type	Description
itemKey	String, Number	String or number key

Returns

PageItem

---

PageItems.removeAll()

app.activeDocument.pageItems.removeAll()

Description

Deletes all elements in this collection.

Returns

Nothing.

---

Example

Getting references to external files in page items

// Gets all file-references in the current document using the pageItems object,
// then displays them in a new document

if (app.documents.length > 0) {
    var fileReferences = new Array();
    var sourceDoc = app.activeDocument;

    for (var i = 0; i < sourceDoc.pageItems.length; i++) {
        var artItem = sourceDoc.pageItems[i];
        switch (artItem.typename) {
        case "PlacedItem":
            fileReferences.push(artItem.file.fsName);
            break;
        case "RasterItem":
            if (!artItem.embedded) {
                fileReferences.push(artItem.file.fsName);
            }
            break;
        }
    }

    // Write the file references to a new document
    var reportDoc = documents.add();
    var areaTextPath = reportDoc.pathItems.rectangle(reportDoc.height, 0, reportDoc.width, reportDoc.height);
    var fileNameText = reportDoc.textFrames.areaText(areaTextPath);
    fileNameText.textRange.size = 24;
    var paragraphCount = 3;
    var sourceName = sourceDoc.name;
    var text = "File references in \'" + sourceName + "\':\r\r";
    for (i = 0; i < fileReferences.length; i++) {
        text += (fileReferences[i] + "\r");
        paragraphCount++;
    }
    fileNameText.contents = text;
}