移动排序条件

Sorts.ChangeOrder(方法)

说明

移动排序条件(设置排序优先级)

语法

表达式.ChangeOrder(FromField, BeforeField, AfterField)

表达式: Sorts

参数

参数名	是否必需	类型	描述
FromField	是	[string]	要移动的排序字段的字段ID/要移动的排序字段的字段名称(名称要以@字符作为开始)
BeforeField	否	[string]	目标位置前的排序字段ID/目标位置前的排序字段名称(名称要以@字符作为开始)
AfterField	否	[string]	目标位置后的排序字段ID/目标位置后的排序字段名称(名称要以@字符作为开始)

FromField、BeforeField和AfterField必须都是已设置的排序条件字段，BeforeField和AfterField至少需要传入一个，如果BeforeField和AfterField同时存在以BeforeField作为应用参数

比如表格视图中已设置的排序条件在排序面板中从上到下依次为【公式，日期，名称，数量】 现在想将名称这条排序条件移动到日期的前面，结果变为【公式，名称，日期，数量】，就可以用以下方式实现

await WPSOpenApi.Application.Sheets(1).Views(1).Sorts.ChangeOrder('@名称', '@日期')

返回值

Boolean

浏览器环境示例

async function example() {
    await instance.ready();
    const app = instance.Application;
    const sorts = await app.Sheets(1).Views(1).Sorts;
    // 将公式排序条件移动到日期排序条件的后面
    const res = await sorts.ChangeOrder('@公式', undefined, '@日期');
    if (res.Code === 0) {
        console.log("设置排序优先级成功")
    } else {
        console.error("设置排序优先级失败" + res.Message)
    }
}

脚本编辑器 示例

function main() {
    const sorts = Application.Sheets(1).Views(1).Sorts;
    // 将公式排序条件移动到日期排序条件的后面
    const res = sorts.ChangeOrder('@公式', undefined, '@日期');
    if (res.Code === 0) {
        console.log("设置排序优先级成功")
    } else {
        console.error("设置排序优先级失败" + res.Message)
    }
}
main()