WPS 基础接口 > 文字 API 参考 > Range > Range 对象成员

代表文档中的一个连续区域。每个 Range 对象由一个起始字符位置和一个终止字符位置定义。

方法

?名称说明
AutoFormat自动给文档套用格式。使用 Kind 属性指定文档类型。
Calculate计算某一区域或选定内容中的数学表达式。返回结果为 Single 类型。
CheckGrammar开始对指定的区域执行拼写和语法检查。
CheckSpelling开始对指定的文档或区域进行拼写检查。
CheckSynonyms显示“同义词库”对话框,为指定区域中的文字列出可替换单词或同义词。
Collapse将某一区域或所选内容折叠到起始位置或结束位置。折叠之后起始位置和结束位置相同。
ComputeStatistics返回一个 Long 类型的值,该值代表基于指定范围内容的统计值。
ConvertHangulAndHanja将指定区域的朝鲜文字转换为朝鲜文汉字,或进行相反的转换。
ConvertToTable将范围内的文本转换为表格。将该表格作为一个 Table 对象返回。
Copy将指定范围复制到剪贴板。
CopyAsPictureCopyAsPicture 方法与 Copy 方法的工作方式相同。
Cut将指定对象从文档中移到剪贴板上。
Delete删除指定数量的字符或单词。
DetectLanguage分析指定文本,以确定书写文本的语言类型。
EndOf将区域的结束字符位置移动或扩展到最近的一个指定文本单位末尾。
Expand扩展指定区域或选定内容。返回添至该区域或选定内容的字符数。Long 类型。
ExportAsFixedFormat将文档的一部分保存为 PDF 或 XPS 格式。
ExportFragment 将所选区域导出到文档中,以便用作文档片段。
GetSpellingSuggestions返回一个 SpellingSuggestions 集合,该集合代表指定范围内第一个单词的建议拼写替换单词。
GoTo返回一个 Range 对象,该对象代表指定项(如页、书签或域)的起始位置。
GoToEditableRange返回一个 Range 对象,该对象代表指定用户或用户组可以修改的文档区域。
GoToNext返回一个 Range 对象,该对象代表下一项目的起始位置或者由 What 参数指定的位置。
GoToPrevious返回一个 Range 对象,该对象参考前一项目的起始位置或者由参数 What 指定的位置。
ImportFragment 将文档片段导入文档中的指定区域。
InRange如果应用此方法的范围包含在由参数 Range 指定的范围内,则该方法返回 True
InsertAfter在范围的末尾插入指定文本。
InsertAlignmentTab 相对于边距或缩进插入始终位于同一点的绝对制表符。
InsertAutoText尝试将指定区域中的文字或某一区域周围的文字与现有的“自动图文集”词条名称相匹配。
InsertBefore在指定的范围前插入指定文本。
InsertBreak插入分页符、分栏符或分节符。
InsertCaption紧接在指定范围之前或之后插入题注。
InsertCrossReference插入对标题、书签、脚注、尾注或定义了题注标签的项(如公式、图表或表格)的交叉引用。
InsertDatabase从数据源(例如,单独的 WPS 文档、WPS OfficeET 工作表或 WPS OfficeAccess 数据库)检索数据,并以表格形式插入数据,以替换指定区域。
InsertDateTime以文本或 TIME 域的形式插入当前日期或时间,或将两者都插入。
InsertFile插入指定文件的全部或一部分。
InsertParagraph用新段落替换指定范围。
InsertParagraphAfter在范围之后插入段落标记。
InsertParagraphBefore在指定的范围前插入一个新段落。
InsertSymbol插入一个符号,用于替换指定的范围。
InsertXML 将指定的 XML 插入文档中的指定区域,并且替换该区域中包含的任何文本。
InStory 如果应用此方法的范围与 Range 参数指定的范围位于相同的文章?(文章:包含文档中可区别于其他文字区域的文字区域。例如,如果文档包括正文文本、脚注和标题,则文章包含主文章、脚注文章和标题文章。)中,则该方法返回 True
IsEqual 如果应用此方法的范围等于 Range 参数所指定的范围,则该方法返回 True
LookupNameProperties在全局通讯簿列表中查找姓名,并显示“属性”对话框,该对话框中包含有关指定姓名的信息。
ModifyEnclosure添加、修改或删除指定字符周围的圈号。
Move将指定范围折叠到其起始位置或结束位置,然后将折叠后的对象移动指定的单位数。
MoveEnd移动范围的结束字符位置。
MoveEndUntil移动指定范围的结束位置,直到在文档中找到任何指定的字符。如果在文档中是向前移动,则扩展该范围。
MoveEndWhile在文档找到任何指定的字符时,移动某一范围的结束字符位置。
MoveStart移动指定范围的起始位置。
MoveStartUntil移动指定范围的起始位置,直到在文档中找到一个指定的字符。
MoveStartWhile当在文档中找到任何指定的字符时,移动指定范围的起始位置。
MoveUntil移动指定范围,直到在文档中找到指定字符中的一个为止。
MoveWhile当在文档中找到任何指定的字符时,移动指定范围。
Next返回一个 Range 对象,该对象代表相对于指定范围的指定单位。
NextSubdocument将范围移至下一个子文档。
Paste将“剪贴板”中的内容插入指定范围。
PasteAndFormat粘贴选定的表格单元格,并为其设置指定的格式。
PasteAppendTable通过在所选行之间插入粘贴的行,将粘贴的单元格合并到现有的表格中。不覆盖任何单元格。
PasteAsNestedTable将一个或一组单元格作为嵌套表格粘贴到所选范围。
PasteExcelTable粘贴 ET 表格并设置其格式。
PasteSpecial插入剪贴板中的内容。
PhoneticGuide将拼音指南添加到指定区域。
Previous返回相对于指定范围的前一个范围。
PreviousSubdocument将范围移至上一个子文档。
Relocate在大纲视图中,将指定区域中各段移至下一个可见段落之后或上一个可见段落之前。
Select选择指定的范围。
SetListLevel 为编号列表中的一个或多个项目设置列表级别。
SetRange设置现有范围的起始字符和结束字符的位置。
Sort对指定范围中的段落进行排序。
SortAscending按字母数字升序对段落或表格行进行排序。
SortDescending按字母数字降序对段落进行排序。
StartOf将指定的区域或选定内容的开始位置移动或扩展至最近的指定文字单位的开头。该方法返回 Long 类型的值表明了区域或选定内容移动或扩展的字符数。如果是在文档中向后移动,则该方法返回负数。
TCSCConverter将指定区域的文本由繁体中文转换为简体中文,或进行相反转换。
WholeStory扩展某一范围使其包含整个文章?(文章:包含文档中可区别于其他文字区域的文字区域。例如,如果文档包括正文文本、脚注和标题,则文章包含主文章、脚注文章和标题文章。)

属性

?名称说明
Application返回一个代表 WPS 应用程序的 Application 对象。
Bold 如果选定区域中字体的格式为加粗,则该属性值为 TrueLong 类型,可读写。
BoldBi 如果字体或区域为加粗格式,则为 True。该属性值返回 TrueFalsewdUndefined(用于加粗和非加粗混合文本)。可设置为 TrueFalsewdToggleLong 类型,可读写。
BookmarkID返回位于指定区域开始位置的书签编号。如果没有相应的书签,则返回 0(零)。Long 类型,只读。
Bookmarks返回一个 Bookmarks 集合,该集合代表某一文档、区域或选定内容中的所有书签。只读。
Borders返回一个 Borders 集合,该集合代表指定对象的所有边框。
Case返回或设置一个 WdCharacterCase 常量,该常量代表指定区域中文字的大小写。可读写。
Cells返回一个 Cells 集合,该集合代表某个区域中的表格单元格。只读。
Characters返回一个 Characters 集合,该集合代表区域中的字符。只读。
CharacterStyle返回一个 Variant 类型的值,该值代表用于设置一个或多个字符格式的样式。只读。
CharacterWidth返回或设置指定区域的字符宽度。WdCharacterWidth 类型,可读写。
Columns返回一个 Columns 集合,该集合代表区域中的所有表格列。只读。
CombineCharacters 如果指定区域包含合并字符,则该属性值为 TrueBoolean 类型,可读写。
Comments返回一个 Comments 集合,该集合代表指定文档、选定内容或区域中的所有批注。只读。
Conflicts返回一个 Conflicts 集合对象,该对象包含区域中的所有冲突对象。只读。
ContentControls返回一个 ContentControls 集合,该集合代表一个区域中包含的内容控件。只读。
Creator返回表示用于创建指定对象的应用程序的 32 位整数。只读 Long 类型。
DisableCharacterSpaceGrid 如果 WPS 忽略相应 Range 对象的每行字符数,则该属性值为 TrueBoolean 类型,可读写。
Document返回一个与指定区域相关联的 Document 对象。只读。
Duplicate返回一个只读 Range 对象,该对象代表指定区域的所有属性。
Editors返回一个 Editors 对象,该对象代表已授权修改文档中选定内容或区域的所有用户。
EmphasisMark返回或设置字符或指定的字符串的着重号。WdEmphasisMark 类型,可读写。
End返回或设置某区域中结束字符的位置。可读/写 Long 类型。
EndnoteOptions返回一个 EndnoteOptions 对象,该对象代表区域中的尾注。
Endnotes返回一个 Endnotes 集合,该集合代表区域中的所有尾注。只读。
EnhMetaFileBits返回一个 Variant 类型的值,该值代表文本区域的显示方式的图片代表形式。
Fields返回一个 Fields 集合,该集合代表区域中的所有字段。只读。
Find返回一个 Find 对象,该对象包含查找操作所需的条件。只读。
FitTextWidth该属性返回或设置 WPS 在当前选定内容或区域中填入文字的宽度(使用当前的度量单位)。Single 类型,可读写。
Font返回或设置一个 Font 对象,该对象代表指定对象的字符格式。可读写 Font
FootnoteOptions返回 FootnoteOptions 对象,该对象代表选定内容或区域的脚注。
Footnotes返回一个 Footnotes 集合,该集合代表区域中的所有脚注。只读。
FormattedText返回或设置一个 Range 对象,该对象包含指定区域或选定内容中进行过格式编排的文字。可读写。
FormFields返回一个 FormFields 集合,该集合代表区域中的所有表单字段。只读。
Frames返回一个 Frames 集合,该集合代表区域中的所有框架。只读。
GrammarChecked 如果已经检查了指定范围或文档的语法,则该属性值为 TrueBoolean 类型,可读写。
GrammaticalErrors返回一个 ProofreadingErrors 集合,该集合代表指定文档或区域中有语法检查错误的句子。只读。
HighlightColorIndex返回或设置指定区域的突出显示颜色。WdColorIndex 类型,可读写。
HorizontalInVertical返回或设置位于垂直排列文字中的水平排列文字的格式。WdHorizontalInVerticalType 类型,可读写。
HTMLDivisions返回一个 HTMLDivisions 对象,该对象代表 Web 文档中的 HTML 划分。
Hyperlinks返回一个 Hyperlinks 集合,该集合代表指定范围内的所有超链接。只读。
ID返回或设置特定范围的标识名称。可读写 String 类型。
Information返回有关指定范围的信息。只读 Variant 类型。
InlineShapes返回一个 InlineShape 集合,该集合代表范围中的所有 InlineShapes 对象。只读。
IsEndOfRowMark 如果指定范围被折叠且位于表格中的行尾标志处,则该属性值为 True。只读 Boolean 类型。
Italic 如果将字体或范围设置为倾斜格式,则该属性值为 TrueLong 类型,可读写。
ItalicBi 如果将字体或范围设置为倾斜格式,则该属性值为 TrueLong 类型,可读写。
Kana返回或设置日文文本的指定区域是平假名还是片假名。WdKana 类型,可读写。
LanguageDetected返回或设置一个值,该值指定 WPS 是否已经检测过指定文本的语言。可读/写 Boolean 类型。
LanguageID返回或设置一个 WdLanguageID 常量,该常量代表指定范围的语言。可读写。
LanguageIDFarEast为指定的对象返回或设置东亚语言。WdLanguageID 类型,可读写。
LanguageIDOther返回或设置指定范围的语言。可读写 WdLanguageID 类型。
ListFormat返回一个 ListFormat 对象,该对象代表某区域中所有的列表格式特征。只读。
ListParagraphs返回一个 ListParagraphs 集合,该集合代表范围中的所有编号段落。只读。
ListStyle返回一个 Variant 类型的值,该值代表用于设置项目符号列表或编号列表的样式。只读。
Locks返回一个 CoAuthLocks 集合对象,该对象代表区域中的所有锁。只读。
NextStoryRange返回一个 Range 对象,该对象代表下一个文章?(文章:单个文本框或一串相链接文本框中包含的文字。)Range 类型,只读。
NoProofing 如果拼写和语法检查程序忽略指定文本,则该属性值为 True。可读写 Long 类型。
OMaths返回一个 OMaths 集合,该集合代表指定区域中的 OMath 对象。只读。
Orientation在启用了“文字方向”功能时返回或设置范围中文字的方向。可读写 WdTextOrientation 类型。
PageSetup返回一个 PageSetup 对象,该对象与指定范围相关联。
ParagraphFormat返回或设置一个 ParagraphFormat 对象,该对象代表指定区域的段落设置。可读写。
Paragraphs返回一个 Paragraphs 集合,该集合代表指定范围中的所有段落。只读。
ParagraphStyle返回一个 Variant 类型的值,该值代表用于设置段落格式的样式。只读。
Parent返回一个 Object 类型的值,该值代表指定 Range 对象的父对象。
ParentContentControl返回一个 ContentControl 对象,该对象代表指定区域的父内容控件。只读。
PreviousBookmarkID返回最后一个书签的编号,该书签从指定范围的前面或与指定范围相同的位置开始。只读 Long 类型。
ReadabilityStatistics返回一个 ReadabilityStatistics 集合,该集合代表指定文档或范围的可读性统计信息。只读。
Revisions返回一个 Revisions 集合,该集合代表范围中的修订。只读。
Rows返回一个 Rows 集合,该集合代表范围中的所有表格行。只读。
Scripts返回一个 Scripts 集合,该集合代表指定对象中 HTML 脚本的集合。
Sections返回一个 Sections 集合,该集合代表指定范围中的各节。只读。
Sentences返回一个 Sentences 集合,该集合代表范围中的所有句子。只读。
Shading返回一个 Shading 对象,该对象代表指定对象的底纹格式。
ShapeRange返回一个 ShapeRange 集合,该集合代表指定区域中的所有 Shape 对象。只读。
ShowAll 如果显示所有非打印字符(如隐藏文字、制表符、空格和段落标记),则该属性值为 True。可读写 Boolean 类型。
SpellingChecked 如果已对指定的区域或文档完成拼写检查,则该属性值为 True。如果所有或部分区域或文档尚未进行拼写检查,则该属性值为 FalseBoolean 类型,可读写。
SpellingErrors返回一个 ProofreadingErrors 集合,该集合代表指定范围中标识为拼写错误的单词。只读。
Start返回或设置某区域中起始字符的位置。Long 类型,可读写。
StoryLength返回包含指定区域的文章?(文章:包含文档中可区别于其他文字区域的文字区域。例如,如果文档包括正文文本、脚注和标题,则文章包含主文章、脚注文章和标题文章。)中的字符数。Long 类型,只读。
StoryType返回指定范围、所选内容或书签的文章?(文章:单个文本框或一串相链接文本框中包含的文字。)类型。只读 WdStoryType 类型。
Style返回或设置指定对象的样式。可读写 Variant 类型。
Subdocuments返回一个 Subdocuments 集合,该集合代表指定范围或文档中的所有子文档。只读。
SynonymInfo返回一个 SynonymInfo 对象,该对象包含同义词库中有关某范围的内容的同义词、反义词或相关单词和表达方式的信息。
Tables返回一个 Tables 集合,该集合代表指定范围内的所有表格。只读。
TableStyle返回一个 Variant 类型的值,该值代表用于设置表格格式的样式。只读。
Text返回或设置指定区域或选定内容中的文本。可读写 String 类型。
TextRetrievalMode返回一个 TextRetrievalMode 对象,该对象控制如何从指定的区域检索文本。可读写。
TopLevelTables返回一个 Tables 集合,该集合代表当前范围最外部嵌套层上的表格。只读。
TwoLinesInOne返回或设置 WPS 是否将两行文本合并为一行,并指定括住文本的字符(如果有)。WdTwoLinesInOneType 类型,可读写。
Underline返回或设置应用于范围的下划线的类型。可读写 WdUnderline 类型。
Updates返回一个 CoAuthUpdates 集合对象,该对象代表区域中的所有可用更新。只读。
WordOpenXML返回一个 String 类型的值,该值以 WPS Open XML 格式表示区域中包含的 XML。只读。
Words返回一个 Words 集合,该集合代表范围中的所有单词。只读。
XML返回一个 String 类型的值,该值代表指定对象中的 XML 文本。
XMLNodes返回一个 XMLNodes 集合,该集合代表指定区域中的 XML 元素(包括任何只是部分属于该区域的元素)。只读。
XMLParentNode 返回一个 XMLNode 对象,该对象代表区域的父级 XML 节点。只读。