PathItem

app.activeDocument.pathItems[index]

描述

指定一个路径项，其中包含定义其几何形状的 PathPoint 对象。

PathItem 类提供了对 Illustrator 中路径的完全访问。

setEntirePath 方法提供了一种非常高效的方式来创建由直线组成的路径。

属性

PathItem.area

app.activeDocument.pathItems[index].area

描述

该路径的面积（以平方点为单位）。

如果面积为负，则路径是逆时针方向的。

自相交路径可能包含相互抵消的子区域，这使得即使路径有明显的面积，该值也可能为零。

类型

Number (double)；只读。

PathItem.artworkKnockout

app.activeDocument.pathItems[index].artworkKnockout

描述

此对象是否用于创建挖空效果，如果是，挖空类型是什么。

类型

KnockoutState

PathItem.blendingMode

app.activeDocument.pathItems[index].blendingMode

描述

合成对象时使用的混合模式。

类型

BlendModes

PathItem.clipping

app.activeDocument.pathItems[index].clipping

描述

如果为 true，此路径应作为剪切路径使用。

类型

Boolean

PathItem.closed

app.activeDocument.pathItems[index].closed

描述

如果为 true，此路径是闭合的。

类型

Boolean

PathItem.controlBounds

app.activeDocument.pathItems[index].controlBounds

描述

对象的边界，包括描边宽度和控件。

类型

4 个数字的数组；只读。

PathItem.editable

app.activeDocument.pathItems[index].editable

描述

如果为 true，此项目是可编辑的。

类型

Boolean；只读。

PathItem.evenodd

app.activeDocument.pathItems[index].evenodd

描述

如果为 true，应使用奇偶规则来确定“内部”。

类型

Boolean

PathItem.fillColor

app.activeDocument.pathItems[index].fillColor

描述

路径的填充颜色。

类型

Color

PathItem.filled

app.activeDocument.pathItems[index].filled

描述

如果为 true，路径被填充。

类型

Boolean

PathItem.fillOverprint

app.activeDocument.pathItems[index].fillOverprint

描述

如果为 true，填充对象下方的图稿应进行叠印。

类型

Boolean

PathItem.geometricBounds

app.activeDocument.pathItems[index].geometricBounds

描述

对象的边界，不包括描边宽度。

类型

4 个数字的数组；只读。

PathItem.guides

app.activeDocument.pathItems[index].guides

描述

如果为 true，此路径是参考线对象。

类型

Boolean

PathItem.height

app.activeDocument.pathItems[index].height

描述

组项目的高度。

类型

Number (double)

PathItem.hidden

app.activeDocument.pathItems[index].hidden

描述

如果为 true，此项目是隐藏的。

类型

Boolean

PathItem.isIsolated

app.activeDocument.pathItems[index].isIsolated

描述

如果为 true，此对象是隔离的。

类型

Boolean

PathItem.layer

app.activeDocument.pathItems[index].layer

描述

此项目所属的图层。

类型

Layer；只读。

PathItem.left

app.activeDocument.pathItems[index].left

描述

项目左侧的位置（以点为单位，从页面左侧测量）。

类型

Number (double)

PathItem.length

app.activeDocument.pathItems[index].length

描述

此路径的长度（以点为单位）。

类型

Number (double)

PathItem.locked

app.activeDocument.pathItems[index].locked

描述

如果为 true，此项目是锁定的。

类型

Boolean

PathItem.name

app.activeDocument.pathItems[index].name

描述

此项目的名称。

类型

String

PathItem.note

app.activeDocument.pathItems[index].note

描述

分配给此项目的注释。

类型

String

PathItem.opacity

app.activeDocument.pathItems[index].opacity

描述

对象的不透明度。

范围：0.0 到 100.0

类型

Number (double)

PathItem.parent

app.activeDocument.pathItems[index].parent

描述

此对象的父对象。

类型

Layer 或 GroupItem

PathItem.pathPoints

app.activeDocument.pathItems[index].pathPoints

描述

此路径项中包含的路径点。

类型

PathPoints；只读。

PathItem.pixelAligned

app.activeDocument.pathItems[index].pixelAligned

描述

如果为 true，此项目对齐到像素网格。

类型

Boolean

PathItem.polarity

app.activeDocument.pathItems[index].polarity

描述

路径的极性。

类型

PolarityValues

PathItem.position

app.activeDocument.pathItems[index].position

描述

pluginItem 对象左上角的位置（以点为单位），格式为 [x, y]。不包括描边宽度。

类型

2 个数字的数组；只读。

PathItem.resolution

app.activeDocument.pathItems[index].resolution

描述

路径的分辨率（以每英寸点数 (dpi) 为单位）。

类型

Number (double)

PathItem.selected

app.activeDocument.pathItems[index].selected

描述

如果为 true，此项目被选中。

类型

Boolean

PathItem.selectedPathPoints

app.activeDocument.pathItems[index].selectedPathPoints

描述

路径中所有选中的路径点。

类型

PathPoints；只读。

PathItem.sliced

app.activeDocument.pathItems[index].sliced

描述

如果为 true，项目被切片。

默认值：false

类型

Boolean

PathItem.strokeCap

app.activeDocument.pathItems[index].strokeCap

描述

线帽的类型。

类型

StrokeCap

PathItem.strokeColor

app.activeDocument.pathItems[index].strokeColor

描述

路径的描边颜色。

类型

Color

PathItem.stroked

app.activeDocument.pathItems[index].stroked

描述

如果为 true，路径应描边。

类型

Boolean

PathItem.strokeDashes

app.activeDocument.pathItems[index].strokeDashes

描述

虚线长度。设置为空对象 {} 表示实线。

类型

Object

PathItem.strokeDashOffset

app.activeDocument.pathItems[index].strokeDashOffset

描述

虚线图案中默认开始的距离。

类型

Number (double)

PathItem.strokeJoin

app.activeDocument.pathItems[index].strokeJoin

描述

路径的连接类型。

类型

StrokeJoin

PathItem.strokeMiterLimit

app.activeDocument.pathItems[index].strokeMiterLimit

描述

当默认描边连接设置为斜接时，此属性指定何时将连接转换为斜切（方形）。默认的斜接限制为 4 表示当点的长度达到描边宽度的四倍时，连接将从斜接连接转换为斜切连接。值为 1 表示斜切连接。

范围：1 到 500。

默认值：4

类型

Number (double)

PathItem.strokeOverprint

app.activeDocument.pathItems[index].strokeOverprint

描述

如果为 true，描边对象下方的图稿应进行叠印。

类型

Boolean

PathItem.strokeWidth

app.activeDocument.pathItems[index].strokeWidth

描述

描边的宽度（以点为单位）。

类型

Number (double)

PathItem.tags

app.activeDocument.pathItems[index].tags

描述

此项目中包含的标签。

类型

Tags；只读。

PathItem.top

app.activeDocument.pathItems[index].top

描述

项目顶部的位置（以点为单位，从页面底部测量）。

类型

Number (double)

PathItem.typename

app.activeDocument.pathItems[index].typename

描述

引用对象的类名。

类型

String；只读。

PathItem.uRL

app.activeDocument.pathItems[index].uRL

描述

分配给此项目的 Adobe URL 标签的值。

类型

String

PathItem.visibilityVariable

app.activeDocument.pathItems[index].visibilityVariable

描述

绑定到项目的可见性变量。

类型

Variable

PathItem.visibleBounds

app.activeDocument.pathItems[index].visibleBounds

描述

项目的可见边界，包括描边宽度。

类型

4 个数字的数组；只读。

PathItem.width

app.activeDocument.pathItems[index].width

描述

项目的宽度。

类型

Number (double)

PathItem.wrapInside

app.activeDocument.pathItems[index].wrapInside

描述

如果为 true，文本框架对象应在此对象内部换行。

类型

Boolean

PathItem.wrapOffset

app.activeDocument.pathItems[index].wrapOffset

描述

围绕此对象换行文本时使用的偏移量。

类型

Number (double)

PathItem.wrapped

app.activeDocument.pathItems[index].wrapped

描述

如果为 true，围绕此对象换行文本框架对象（文本框架必须位于对象上方）。

类型

Boolean

PathItem.zOrderPosition

app.activeDocument.pathItems[index].zOrderPosition

描述

此项目在包含该项目的组或图层（parent）中的堆叠顺序中的位置。

类型

Number；只读。

方法

PathItem.duplicate()

app.activeDocument.pathItems[index].duplicate([relativeObject][, insertionLocation])

描述

创建所选对象的副本。

参数

参数	类型	描述
`relativeObject`	Object, 可选	要复制到的对象
`insertionLocation`	ElementPlacement, 可选	插入元素的位置

返回值

PathItem

PathItem.move()

app.activeDocument.pathItems[index].move(relativeObject, insertionLocation)

描述

移动对象。

参数

参数	类型	描述
`relativeObject`	Object	要移动元素的对象
`insertionLocation`	ElementPlacement, 可选	移动元素到的位置

返回值

PathItem

PathItem.remove()

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

描述

删除此对象。

返回值

无。

PathItem.resize()

app.activeDocument.pathItems[index].resize(
    scaleX,
    scaleY
    [,changePositions]
    [,changeFillPatterns]
    [,changeFillGradients]
    [,changeStrokePattern]
    [,changeLineWidths]
    [,scaleAbout]
)

描述

缩放图稿项，其中 scaleX 是水平缩放因子，scaleY 是垂直缩放因子。100.0 = 100%。

参数

参数	类型	描述
`scaleX`	Number (double)	水平缩放因子
`scaleY`	Number (double)	垂直缩放因子
`changePositions`	Boolean, 可选	是否影响图稿对象的位置和方向
`changeFillPatterns`	Boolean, 可选	是否变换填充图案
`changeFillGradients`	Boolean, 可选	是否变换填充渐变
`changeStrokePattern`	Boolean, 可选	是否变换描边图案
`changeLineWidths`	Number (double), 可选	缩放线宽的量
`scaleAbout`	Transformation, 可选	用作锚点的点，用于变换

返回值

无。

PathItem.rotate()

app.activeDocument.pathItems[index].rotate(
    angle
    [,changePositions]
    [,changeFillPatterns]
    [,changeFillGradients]
    [,changeStrokePattern]
    [,rotateAbout]
)

描述

相对于当前旋转角度旋转图稿项。

如果 angle 值为正，则对象逆时针旋转；如果值为负，则顺时针旋转。

参数

参数	类型	描述
`angle`	Number (double)	旋转元素的角度量
`changePositions`	Boolean, 可选	是否影响图稿对象的位置和方向
`changeFillPatterns`	Boolean, 可选	是否变换填充图案
`changeFillGradients`	Boolean, 可选	是否变换填充渐变
`changeStrokePattern`	Boolean, 可选	是否变换描边图案
`rotateAbout`	Transformation, 可选	用作锚点的点，用于变换

返回值

无。

PathItem.setEntirePath()

app.activeDocument.pathItems[index].setEntirePath(pathPoints)

描述

使用 [x, y] 坐标对的数组设置路径。

参数

参数	类型	描述
`pathPoints`	[x, y] 坐标对的数组	要设置的点坐标数组

返回值

无。

PathItem.transform()

app.activeDocument.pathItems[index].transform(
    transformationMatrix
    [, changePositions]
    [, changeFillPatterns]
    [, changeFillGradients]
    [, changeStrokePattern]
    [, changeLineWidths]
    [, transformAbout]
)

描述

通过应用变换矩阵来变换图稿项。

参数

参数	类型	描述
`transformationMatrix`	Matrix	要应用的变换矩阵
`changePositions`	Boolean, 可选	是否更改位置
`changeFillPatterns`	Boolean, 可选	是否更改填充图案
`changeFillGradients`	Boolean, 可选	是否更改填充渐变
`changeStrokePattern`	Boolean, 可选	是否更改描边图案
`changeLineWidths`	Number (double), 可选	缩放线宽的量
`transformAbout`	Transformation, 可选	用作锚点的点，用于变换

返回值

无。

PathItem.translate()

app.activeDocument.pathItems[index].translate(
    [deltaX]
    [, deltaY]
    [, transformObjects]
    [, transformFillPatterns]
    [, transformFillGradients]
    [, transformStrokePatterns]
)

描述

相对于当前位置重新定位图稿项，其中 deltaX 是水平偏移量，deltaY 是垂直偏移量。

参数

参数	类型	描述
`deltaX`	Number (double), 可选	水平偏移量
`deltaY`	Number (double), 可选	垂直偏移量
`transformObjects`	Boolean, 可选	是否变换对象
`transformFillPatterns`	Boolean, 可选	是否变换填充图案
`transformFillGradients`	Boolean, 可选	是否变换填充渐变
`transformStrokePatterns`	Boolean, 可选	是否变换描边图案

返回值

无。

PathItem.zOrder()

app.activeDocument.pathItems[index].zOrder(zOrderCmd)

描述

在组或图层（父对象）的堆叠顺序中排列图稿项的位置。

参数

参数	类型	描述
`zOrderCmd`	ZOrderMethod	堆叠顺序排列方法

返回值

无。

示例

设置路径中的颜色

//  将路径项的描边和填充设置为随机选择的色板的颜色
if (app.documents.length > 0 && app.activeDocument.pathItems.length > 0) {
    var doc = app.activeDocument;

    for (var i = 0; i < doc.pathItems.length; i++) {
        var pathRef = doc.pathItems[i];
        pathRef.filled = true;
        pathRef.stroked = true;

        var swatchIndex = Math.round(Math.random() * (doc.swatches.length - 1));
        pathRef.fillColor = doc.swatches[swatchIndex].color;
        pathRef.strokeColor = doc.swatches[swatchIndex].color;
    }
}

用直线创造路径

// 此脚本演示了 setEntirePath 方法的使用。
// 创建一个由10条直线组成的新开放路径
if (app.documents.length > 0) {
    var lineList = [];

    for (i = 0; i < lineList.length; i++) {
        lineList.push([i * 10 + 50, ((i - 5) ^ 2) * 5 + 50];
    }

    app.defaultStroked = true;
    newPath = app.activeDocument.pathItems.add();
    newPath.setEntirePath(lineList);
}