TextFrameItems

app.activeDocument.textFrames

描述

文档中 TextFrameItem 对象的集合。

属性

TextFrameItems.length

app.activeDocument.textFrames.length

描述

集合中元素的数量。

类型

数字；只读。

TextFrameItems.parent

app.activeDocument.textFrames.parent

描述

对象的容器。

类型

对象；只读。

TextFrameItems.typename

app.activeDocument.textFrames.typename

描述

引用对象的类名。

类型

字符串；只读。

方法

TextFrameItems.add()

app.activeDocument.textFrames.add()

描述

创建一个点文本框架项。

返回值

TextFrameItem

TextFrameItems.areaText()

app.activeDocument.textFrames.areaText(textPath[, orientation][, baseFrame][, postFix])

描述

创建一个区域文本框架项。

参数

参数	类型	描述
`textPath`	PathItem	使用的路径项
`orientation`	TextOrientation, 可选	文本的方向
`baseFrame`	TextFrameItem, 可选	使用的文本框架
`postFix`	布尔值, 可选	是否在文本框架前后添加内容

返回值

TextFrameItem

TextFrameItems.getByName()

app.activeDocument.textFrames.getByName(name)

描述

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

参数

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

返回值

TextFrameItem

TextFrameItems.index()

app.activeDocument.textFrames.index(itemKey)

描述

从集合中获取一个元素。

参数

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

返回值

TextFrameItem

TextFrameItems.pathText()

app.activeDocument.textFrames.pathText(textPath[,startTValue][,endTValue][, orientation][, baseFrame][, postFix])

描述

创建一个路径上的文本框架项。

参数

参数	类型	描述
`textPath`	PathItem	使用的路径项
`startTValue`	数字 (双精度)	文本沿路径的起始位置
`endTValue`	数字 (双精度)	文本沿路径的结束位置
`orientation`	TextOrientation, 可选	文本的方向
`baseFrame`	TextFrameItem, 可选	使用的文本框架
`postFix`	布尔值, 可选	是否在文本框架前后添加内容

返回值

TextFrameItem

TextFrameItems.pointText()

app.activeDocument.textFrames.pointText(anchor[, orientation])

描述

创建一个点文本框架项。

参数

参数	类型	描述
`anchor`	2个数字的数组	点文本锚点
`orientation`	TextOrientation, 可选	文本的方向

返回值

TextFrameItem

TextFrameItems.removeAll()

app.activeDocument.textFrames.removeAll()

描述

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

返回值

无。

示例

创建和修改文本框架

// 创建一个包含路径、区域和点文本框架的文档，
// 修改每个框架的内容，然后删除第二个框架

// 创建一个新文档
var docRef = documents.add();

// 创建3个新的文本框架（区域、路径、点）
// 区域文本
var rectRef = docRef.pathItems.rectangle(700, 50, 100, 100); var areaTextRef = docRef.textFrames.areaText(rectRef); areaTextRef.contents = "TextFrame #1";
areaTextRef.selected = true;

// 路径文本
var lineRef = docRef.pathItems.add();
lineRef.setEntirePath( Array(Array(200, 700), Array(300, 550) ) ); var pathTextRef = docRef.textFrames.pathText(lineRef); pathTextRef.contents = "TextFrame #2";
pathTextRef.selected = true;

// 点文本
var pointTextRef = docRef.textFrames.add(); pointTextRef.contents = "TextFrame #3"; pointTextRef.top = 700;
pointTextRef.left = 400; pointTextRef.selected = true; redraw();

// 计算文本框架的数量
var iCount = docRef.textFrames.length;
var sText = "There are " + iCount + " TextFrames.\r" sText += "Changing contents of each TextFrame.";

// 修改每个文本框架的内容
docRef.textFrames[0].contents = "Area TextFrame."; docRef.textFrames[1].contents = "Path TextFrame."; docRef.textFrames[2].contents = "Point TextFrame."; redraw();
docRef.textFrames[1].remove(); redraw();

// 再次计算
var iCount = docRef.textFrames.length;