GradientStops

GradientStops

app.activeDocument.gradients[index].gradientStops

描述

特定渐变中的 GradientStop 对象集合。元素没有名称，必须通过索引访问。

---

属性

GradientStops.length

app.activeDocument.gradients[index].gradientStops.length

描述

集合中对象的数量。

类型

数字；只读。

---

GradientStops.parent

app.activeDocument.gradients[index].gradientStops.parent

描述

该对象的父对象。

类型

对象；只读。

---

GradientStops.typename

app.activeDocument.gradients[index].gradientStops.typename

描述

引用对象的类名。

类型

字符串；只读。

---

方法

GradientStops.add()

app.activeDocument.gradients[index].gradientStops.add()

描述

创建一个新对象。

返回值

GradientStop

---

GradientStops.getByName()

app.activeDocument.gradients[index].gradientStops.getByName(name)

描述

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

参数

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

返回值

GradientStop

---

GradientStops.index()

app.activeDocument.gradients[index].gradientStops.index(itemKey)

描述

从集合中获取一个元素。

参数

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

返回值

GradientStop

---

GradientStops.removeAll()

app.activeDocument.gradients[index].gradientStops.removeAll()

描述

删除此集合中的所有对象。

返回值

无。

---

示例

添加一个新的渐变停止点

// 向渐变中添加一个新的渐变停止点，新停止点的颜色为 70% 灰色
if (app.documents.length > 0 && app.activeDocument.gradients.length > 0) {
    // 获取要更改的渐变的引用
    var changeGradient = app.activeDocument.gradients[0];

    // 获取最后一个渐变停止点的引用
    var origCount = changeGradient.gradientStops.length;
    var lastStop = changeGradient.gradientStops[origCount - 1];

    // 添加新的渐变停止点
    var newStop = changeGradient.gradientStops.add();

    // 设置新渐变停止点的值。
    // 将原始的最后一个渐变停止点向左移动一点，并在旧位置插入新的渐变停止点
    newStop.rampPoint = lastStop.rampPoint;
    lastStop.rampPoint = lastStop.rampPoint - 10;

    // 创建一个新颜色以应用于新创建的渐变停止点
    var newStopColor = new GrayColor();
    newStopColor.gray = 70.0;
    newStop.color = newStopColor;
}