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 依次按 FieldNumberFieldNumber2FieldNumber3 排序。
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)
}


请参阅