WPS 加载项开发 > 文字 API 参考 > Range > 方法 > Range.Sort 方法
对指定范围中的段落进行排序。

语法

表达式.Sort(ExcludeHeader, FieldNumber, SortFieldType, SortOrder, FieldNumber2, SortFieldType2, SortOrder2, FieldNumber3, SortFieldType3, SortOrder3, SortColumn, Separator, CaseSensitive, BidiSort, IgnoreThe, IgnoreKashida, IgnoreDiacritics, IgnoreHe, LanguageID)

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

参数

名称 必选/可选 数据类型 说明
ExcludeHeader 可选 Variant 如果该参数值为 True,则不对首行或段落标题进行排序。默认值为 False。
FieldNumber 可选 Variant 作为排序依据的域。WPS 依次按 FieldNumber、FieldNumber2、FieldNumber3 排序。
SortFieldType 可选 Variant FieldNumber 各自的排序类型。可以是 WdSortFieldType 常量之一。默认值为 wdSortFieldAlphanumeric。根据您选择或安装的语言支持(例如,美国英语),以上某些常量可能不可用。
SortOrder 可选 Variant 对 FieldNumber 进行排序时使用的排序顺序。可以是任意 WdSortOrder 常量。
FieldNumber2 可选 Variant 作为排序依据的域。
SortFieldType2 可选 Variant FieldNumber2 各自的排序类型。可以是 WdSortFieldType 常量之一。默认值为 wdSortFieldAlphanumeric。根据您选择或安装的语言支持(例如,美国英语),以上某些常量可能不可用。
SortOrder2 可选 Variant 对 FieldNumber2 进行排序时使用的排序顺序。可以是任意 WdSortOrder 常量。
FieldNumber3 可选 Variant 作为排序依据的域。
SortFieldType3 必选 根据您选择或安装的语言支持(例如,美国英语),以上某些常量可能不可用。默认值为 wdSortFieldAlphanumeric。根据您选择或安装的语言支持(例如,美国英语),以上某些常量可能不可用。
SortOrder3 可选 Variant 对 FieldNumber3 进行排序时使用的排序顺序。可以是任意 WdSortOrder 常量。
SortColumn 可选 Variant 如果该参数值为 True,则只对由 Range 对象指定的列进行排序。
Separator 可选 Variant 域分隔符的类型。可以是 WdSortSeparator 常量之一。
CaseSensitive 可选 Variant 如果该参数值为 True,则排序时区分大小写。默认值为 False。
BidiSort 可选 Variant 如果该参数值为 True,则基于从右向左语言的规则进行排序。根据您所选择或安装的语言支持(例如,美国英语),此参数可能不可用。
IgnoreThe 可选 Variant 如果该参数值为 True,则对从右向左的语言文本进行排序时忽略阿拉伯字符 alef lam。根据您所选择或安装的语言支持(例如,美国英语),此参数可能不可用。
IgnoreKashida 可选 Variant 如果该参数值为 True,则对从右向左的语言文本进行排序时忽略 Kashidas。根据您所选择或安装的语言支持(例如,美国英语),此参数可能不可用。
IgnoreDiacritics 可选 Variant 如果该参数值为 True,则对从右向左的语言文本进行排序时忽略双向控制字符。根据您所选择或安装的语言支持(例如,美国英语),此参数可能不可用。
IgnoreHe 可选 Variant 如果该参数值为 True,则对从右向左的语言文本进行排序时忽略希伯来字符 he。根据您所选择或安装的语言支持(例如,美国英语),此参数可能不可用。
LanguageID 可选 Variant 指定排序语言。可以是 WdLanguageID 常量之一。要获得 WdLanguageID 常量的列表,请参阅“对象浏览器”。

示例

以下示例在新文档中插入三行文本,然后按字母数字升序对这些行进行排序。

示例代码
function NewParagraphSort() {
    let newDoc = Documents.Add()
    newDoc.Content.InsertAfter("pear"+ "\r" + "zucchini"+ "\r" + "apple" + "\r")
    newDoc.Content.Sort(null, null, null, wdSortOrderAscending)
}


请参阅