WPS 加载项开发 > 文字 API 参考 > Range > 方法 > Range.EndOf 方法
将区域的结束字符位置移动或扩展到最近的一个指定文本单位末尾。

语法

表达式.EndOf(Unit, Extend)

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

参数

名称 必选/可选 数据类型 说明
Unit 可选 Variant 移动结束字符位置时所基于的单位。可以是任意 WdUnits,但 wdLine 除外。默认值为 wdWord
Extend 必选 WdMovementType 指定是移动还是扩展区域末尾。如果该参数值为 wdMove,则区域和选定内容对象的末尾都移到指定单位的末尾。如果使用 wdExtend,则区域或选定内容的末尾将扩展到指定单位的末尾。默认值为 wdMove

说明

本方法返回该区域或所选内容所移动或扩展的字符位置数(移动方向为向前)。

如果区域或选定内容的开始和结束位置都已在指定单位的末尾,则该方法不移动或扩展此区域或选定内容。例如,如果选定内容位于一个单词和词尾空格末尾,则下列指令不改变选定内容(char 等于 0(零))。

示例代码
let char = Selection.EndOf(wdWord, wdMove)

示例

本示例将选定内容扩展至段落末尾。

示例代码
let charmoved = Selection.EndOf(wdParagraph, wdExtend)
if(charmoved == 0) {
    MsgBox("Selection unchanged")
}

本例将字符串 myRange 移动到选定内容的第一个单词的末尾。

示例代码
let myRange = Selection.Characters.Item(1)
myRange.EndOf(wdWord, wdMove)

本示例先添加一个表格,选择第二行第一个单元,再将选定内容扩展到列末。

示例代码
let myRange = ActiveDocument.Range(0, 0)
let myTable = ActiveDocument.Tables.Add(myRange, 5, 3)
myTable.Cell.Item(2,1).Select()
Selection.EndOf(wdColumn, wdExtend)


请参阅