PageItems

PageItems

app.activeDocument.pageItems

描述

一个包含 PageItem 对象的集合。提供了对 Illustrator 文档中所有艺术项目的完全访问权限，涵盖以下类：

• CompoundPathItem
  • 属性
  • 方法
  • 示例
• GraphItem
  • 属性
  • 方法
• GroupItem
  • 属性
  • 方法
  • 示例
• LegacyTextItem
  • 属性
  • 方法
• MeshItem
  • 属性
  • 方法
  • 示例
• NonNativeItem
  • 属性
  • 方法
• PathItem
  • 属性
  • 方法
  • 示例
• PlacedItem
  • 属性
  • 方法
  • 示例
• PluginItem
  • 属性
  • 方法
  • 示例
• RasterItem
  • 属性
  • 方法
• SymbolItem
  • 属性
  • 方法
• TextFrameItem
  • 属性
  • 方法
  • 示例

你可以通过 Document、Layer 或 GroupItem 中的 PageItems 属性来引用页面项目。

当你访问这些集合中的单个项目时，引用的是特定类型的页面项目。例如，如果你使用 PageItems 来引用一个图表项目，该对象的 typename 值为 GraphItem。

---

属性

PageItems.length

app.activeDocument.pageItems.length

描述

集合中的对象数量。

类型

数字；只读。

---

PageItems.parent

app.activeDocument.pageItems.parent

描述

该对象的父对象。

类型

对象；只读。

---

PageItems.typename

app.activeDocument.pageItems.typename

描述

引用对象的类名。

类型

字符串；只读。

---

方法

PageItems.getByName()

app.activeDocument.pageItems.getByName(name)

描述

获取集合中具有指定名称的第一个元素。

参数

参数	类型	描述
name	字符串	要获取的元素名称

返回值

PageItem

---

PageItems.index()

app.activeDocument.pageItems.index(itemKey)

描述

从集合中获取一个元素。

参数

参数	类型	描述
itemKey	字符串, 数字	字符串或数字键

返回值

PageItem

---

PageItems.removeAll()

app.activeDocument.pageItems.removeAll()

描述

删除此集合中的所有元素。

返回值

无。

---

示例

获取页面项目中的外部文件引用

// 使用 pageItems 对象获取当前文档中的所有文件引用，
// 然后将它们显示在新文档中

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

    // 将文件引用写入新文档
    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 = "文件引用在 \'" + sourceName + "\':\r\r";
    for (i = 0; i < fileReferences.length; i++) {
        text += (fileReferences[i] + "\r");
        paragraphCount++;
    }
    fileNameText.contents = text;
}