Ae 表达式语言引用：Text（After Effects）

Text（文本属性和方法）组主要用于获取和修改 After Effects 中文本图层的样式，包括字体、大小、颜色、行间距、字间距等属性。通过设置和获取不同的文本样式属性，可以动态调整文本外观，如启用仿粗体、仿斜体、描边和填充等效果，还提供了段落相关方法和属性，方便文本排版和样式控制。

sourceText

获取或设置文本图层的源文本内容。

返回值：返回一个 TextDocument 对象，包含文本内容及相关样式。

应用：

//示例 1：获取文本内容
var textContent = text.sourceText;
textContent


//示例 2：设置文本内容
text.sourceText = "新文本";

Font...

用于选择文本所使用的字体。

返回值：返回 PostScript 名称（英文）字符串。比如，Arial，SimSun 等。

Styling

样式

createStyle( )

创建一个新的文本样式对象。

参数：无

返回值：一个新的文本样式对象。

应用：

样式对象的方法一般都会返回修改后的样式对象。

// 示例 1:创建样式并设置特定值（长格式）
styleA = thisComp.layer("mediaTEA").text.sourceText.createStyle();
styleB = styleA.setFontSize(200); 
styleC = styleB.setFont("Arial"); 
styleC;


//示例 2:创建样式并设置特定值（短格式）
styleA = thisComp.layer("mediaTEA").text.sourceText.createStyle();
styleA.setFontSize(100).setFont("Arial");

getStyleAt(charIndex, t=time)

获取指定字符索引位置的文本样式，支持根据时间获取样式。

参数：

charIndex ：Number，字符索引值。提示：字符索引从 0 开始。

t ：可选，指定获取样式的时间点，以秒为单位。默认为当前时间 time。

返回值：Object，返回该字符位置在指定时间点的样式对象。

应用：

// 示例 1：获取第一字符在第 2 秒时的样式
text.sourceText.getStyleAt(0, 2);


// 示例 2：
text.sourceText.getStyleAt(3).fontSize; 
text.sourceText.getStyleAt(0).font

isHorizontalText

检查文本是否为水平文本。

返回值：Boolean，true 表示文本是水平文本，false 表示不是。

应用：

// 示例：
text.sourceText.isHorizontalText;

isParagraphText

检查文本是否为段落文本。

返回值：Boolean，true 表示文本是段落文本，false 表示不是。

应用：

// 示例：
text.sourceText.isParagraphText;

isPointText

检查文本是否为点文本。

返回值：Boolean，true 表示文本是点文本，false 表示不是。

应用：

// 示例：
text.sourceText.isPointText;

style

获取索引是 0 的字符的样式对象。

相当于 getStyleAt(0)。

返回值：Object，返回文本的样式对象。

应用：

//示例 1：指定为另一个文本图层的第 1 个字符的样式对象
thisComp.layer("mediaTEA").text.sourceText.style


//示例 2：为样式设置特定值（短格式）
style.setFontSize(80).setFauxBold(true).setFauxItalic(true)

isVerticalText

检查文本是否为垂直文本。

返回值：Boolean，true 表示文本是垂直文本，false 表示不是。

应用：

// 示例：
text.sourceText.isVerticalText;

Text Methods

文本方法

请参阅：

《Ae 表达式语言引用：Text - Styling -Text Methods》

Text Properties

文本属性

请参阅：

《Ae 表达式语言引用：Text - Styling - Text Properties》

Paragraph Methods

段落方法

请参阅：

《Ae 表达式语言引用：Text - Styling - Paragraph Methods》

Paragraph Properties

段落属性

请参阅：

《Ae 表达式语言引用：Text - Styling - Paragraph Properties》

“点赞有美意，赞赏是鼓励”