WPS 加载项开发 > 演示 API 参考 > TextRange > 方法 > TextRange.Runs 方法
返回一个 TextRange 对象,该对象代表指定的文本域子集。文本域由具有相同字体属性的一些字符组成。有关计算或浏览文本范围中域的详细信息,请参阅 TextRange 对象。

语法

表达式.Runs(Start, Length)

表达式   一个代表 TextRange 对象的变量。

参数

名称 必选/可选 数据类型 描述
Start 可选 Long 返回的范围中的第一个域。
Length 可选 Long 要返回的域数。

返回值
TextRange

说明

如果 Start 和 Length 都被忽略,则返回的范围从指定范围中的第一个域开始,到最后一段结束。

如果指定 Start 但忽略 Length,则返回的范围包含一个域。

如果指定 Length 但忽略 Start,则返回的范围从指定范围中的第一个域开始。

如果 Start 大于指定文本中域的数量,则返回的范围从指定范围中的最后一个域开始。

如果 Length 大于从指定起始域到文本末尾的域数,则返回的范围包含所有这些域。

一个域包含从字体改变后的第一个字符到倒数第二个具有相同字体属性的字符之间的所有字符。以下句为例:

This italic word is not bold.

在上句中,如果“This”后边的空格不是斜体,则第一个域由“This”构成(如果该空格为斜体,则第一个域仅包括前三个字符,即“Thi”)。类似地,仅当“italic”后边的空格为斜体时,第二个域由“italic”构成。

示例

如果当前演示文稿的第一张幻灯片上第二个形状中第二个域已经设为倾斜,则本示例将其设为加粗倾斜。

示例代码
let tRng = Application.ActivePresentation.Slides.Item(1).Shapes.Item(2).TextFrame.TextRange
let f = tRng.Runs(2).Font
if(f.Italic) {
    f.Bold = true
}


请参阅