单词

单词

app.activeDocument.textFrames[index].words

描述

文本项中的单词集合，其中每个单词是一个 TextRange 对象。

元素没有名称；必须通过索引访问它们。

---

属性

Words.length

app.activeDocument.textFrames[index].words.length

描述

集合中对象的数量

类型

数字；只读。

---

Words.parent

app.activeDocument.textFrames[index].words.parent

描述

此对象的父对象。

类型

对象；只读。

---

Words.typename

app.activeDocument.textFrames[index].words.typename

描述

引用对象的类名。

类型

字符串；只读。

---

方法

Words.add()

app.activeDocument.textFrames[index].words.add(contents[, relativeObject][, inseertLocation])

描述

在指定位置向当前文档添加一个单词。

如果未指定位置，则将其添加到包含文本框架中当前单词选择或插入点之后。

参数

参数	类型	描述
contents	字符串	要添加的单词
relativeObject	TextFrameItem，可选	要添加项的对象
insertionLocation	ElementPlacement，可选	插入文本的位置

返回值

TextRange

---

Words.addBefore()

app.activeDocument.textFrames[index].words.addBefore(contents)

描述

在当前单词选择或插入点之前添加一个单词。

参数

参数	类型	描述
contents	字符串	要添加的单词

返回值

TextRange

---

Words.index()

app.activeDocument.textFrames[index].words.index(itemKey)

描述

从集合中获取一个元素。

参数

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

返回值

TextRange

---

Words.removeAll()

app.activeDocument.textFrames[index].words.removeAll()

描述

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

返回值

无。

---

示例

统计单词数量

// 统计当前文档中的所有单词并将总数存储在 numWords 中
if ( app.documents.length > 0 ) {
 var numWords = 0;

 for ( i = 0; i < app.activeDocument.textFrames.length; i++) {
 numWords += app.activeDocument.textFrames[i].words.length;
 }
}

对单词应用属性

// 创建一个新的洋红色并将其应用于符合特定条件的所有单词
if (app.documents.length > 0 && app.activeDocument.textFrames.length > 0) {
 // 创建要应用于单词的颜色
 var wordColor = new RGBColor();
 wordColor.red = 255;
 wordColor.green = 0;
 wordColor.blue = 255;

 // 设置要查找的单词的值 searchWord1 = "the";
 var searchWord2 = "The";
 var searchWord3 = "THE";

 // 遍历文档中的所有单词
 // 并为匹配 searchWord 的单词着色

 for (var i = 0; i < app.activeDocument.textFrames.length; i++) {
 var textArt = activeDocument.textFrames[i];

 for (var j = 0; j < textArt.words.length; j++) {
 var word = textArt.words[j];

      if (word.contents == searchWord1 || word.contents == searchWord2 || word.contents == searchWord3) {
 word.filled = true;
 word.fillColor = wordColor;
 }
 }
 }
}