跳到主要内容

SetAutoFilter

向当前范围添加自动筛选。

语法​

expression.SetAutoFilter(Field, Criteria1, Operator, Criteria2, VisibleDropDown);

expression - 表示 ApiRange 类的变量。

参数​

名称必需/可选数据类型默认值描述
Field可选number | null要作为筛选基准的字段的整数偏移量（从列表左侧开始；最左边的字段是字段一）。如果提供 {null}，则清除范围的自动筛选。
Criteria1可选string | string[] | ApiColor | XlDynamicFilterCriteria条件（字符串；例如「101」）。使用「=」查找空白字段，使用「<>」查找非空白字段，使用「><」在数据类型中选择（无数据）字段。如果省略此参数，条件为「全部」。如果 Operator 为 xlTop10Items，Criteria1 指定项目数（例如「10」）。
Operator可选XlAutoFilterOperator指定筛选类型的 XlAutoFilterOperator 常量。
Criteria2可选string第二个条件（字符串）。与 Criteria1 和 Operator 一起使用以构建复合条件。
VisibleDropDown可选booleanTrue 表示显示筛选字段的自动筛选下拉箭头。False 表示隐藏筛选字段的自动筛选下拉箭头。默认为 True。

返回值​

此方法不返回任何数据。

示例​

此示例按单元格范围设置自动筛选。

// How to automatically filter the specified range values.

// Automatically filter out a range values.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange("A1").SetValue("header");
worksheet.GetRange("A2").SetValue("value2");
worksheet.GetRange("A3").SetValue("value3");
worksheet.GetRange("A4").SetValue("value4");
worksheet.GetRange("A5").SetValue("value5");
let range = worksheet.GetRange("A1:A5");
range.SetAutoFilter(1, ["value2","value3"], "xlFilterValues");