WPS 加载项开发 > 文字 API 参考 > Range > 方法 > Range.GoTo 方法
返回一个 Range 对象,该对象代表指定项(如页、书签或域)的起始位置。

语法

表达式.GoTo(What, Which, Count, Name)

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

参数

名称 必选/可选 数据类型 说明
What 可选 Variant 范围要移动到的项的类别。可以是 WdGoToItem 常量之一。
Which 可选 Variant 范围要移动到的项。可以是 WdGoToDirection 常量之一。
Count 可选 Variant 文档中的项数。默认值为 1。只有正值有效。若要指定一个位于该范围之前的项,可将 wdGoToPrevious 用作 Which 参数,并指定一个 Count 值。
Name 可选 Variant 如果 What 参数为 wdGoToBookmarkwdGoToCommentwdGoToFieldwdGoToObject,则此参数指定一个名称。只有正值有效。若要指定一个位于该范围之前的项,可将 wdGoToPrevious 用作 Which 参数,并指定一个 Count 值。

返回值

说明

以下示例将范围向上移动两行。

示例代码
ActiveDocument.Range().GoTo(wdGoToLine, wdGoToPrevious, 2)

以下示例将所选内容移至下一个 DATE 域。

示例代码
ActiveDocument.Range().GoTo(wdGoToField, null, null, "Date")

以下示例将范围移至文档中的第四行。

示例代码
ActiveDocument.Range().GoTo(wdGoToLine, wdGoToAbsolute, 4)

下列示例的功能等效,都将范围移至文档中的第一个标题处。

示例代码
ActiveDocument.Range().GoTo(wdGoToHeading, wdGoToFirst)
ActiveDocument.Range().GoTo(wdGoToHeading, wdGoToAbsolute, 1)

GoTo 方法与 wdGoToGrammaticalErrorwdGoToProofreadingErrorwdGoToSpellingError 常量一起使用时,返回的 Range 对象中包括所有含语法或拼写错误的文本。

示例

以下示例将插入点移至活动文档中第五个尾注引用标记的前面。

示例代码
if(ActiveDocument.Endnotes.Count >= 5){
    ActiveDocument.Range().GoTo(wdGoToEndnote, wdGoToAbsolute, 5)
}

以下示例将 R1 设置为等于活动文档中第一个脚注引用标记。

示例代码
if(ActiveDocument.Footnotes.Count >= 1){
    let R1 = ActiveDocument.Range().GoTo(wdGoToFootnote, wdGoToFirst)
    R1.Expand(wdCharacter)
}


请参阅