WPS 加载项开发 > 文字 API 参考 > Range > 方法 > Range.StartOf 方法
将指定的区域或选定内容的开始位置移动或扩展至最近的指定文字单位的开头。该方法返回 Long 类型的值表明了区域或选定内容移动或扩展的字符数。如果是在文档中向后移动，则该方法返回负数。

语法

表达式.StartOf(Unit, Extend)

表达式   必选。一个代表 Range 对象的变量。

参数

名称 必选/可选 数据类型 说明
Unit 可选 WdUnits 移动指定区域或选定内容的起始位置时所基于的单位。可以是任意 WdUnits 常量，但 wdLine 除外。默认值为 wdWord。
Extend 可选 WdMovement 指定是移动还是扩展区域开头。如果使用 wdMove，则区域和选定内容的末尾都移至指定单位的开头。如果使用 wdExtend，则区域或选定内容的起点将扩展到指定单位的开头。默认值为 wdMove。

说明

如果指定区域或选定内容的开始已经位于指定单位的开始，则该方法不移动或扩展区域或选定内容。例如，如果选定内容位于一行的开头，则下面的示例返回 0（零），并且不改变选定内容。

示例代码 
let Char = Selection.StartOf(wdLine, wdMove)

示例

本示选定从插入点至该行开始之间的文本。选定字符数保存在 charmoved 中。

示例代码 
Selection.Collapse(wdCollapseStart) 
let charmoved = Selection.StartOf(wdLine, wdExtend)

本示例将选定内容移至段落的开头。

示例代码 
Selection.StartOf(wdParagraph, wdMove)

本示例将 myRange 移至文档第二句的开头（折叠 myRange，并放在第二句的开头）。本示例使用 Select 方法来表明 myRange 的位置。

示例代码 
let myRange = ActiveDocument.Sentences.Item(2)
myRange.StartOf(wdSentence, wdMove)
myRange.Select()


请参阅