criterion1
第一个条件用于筛选数据。 在筛选的情况下
custom
用作运算符。 例如，“
>
50”表示大于 50 的数字，或者“=*s”表示以“s”结尾的值。
在顶部/底部项目/百分比 (情况下用作数字，例如，如果
filterOn
设置为
topItems
) ，则为前 5 个项目的“5”。
criterion2
第二个条件用于筛选数据。 仅在筛选的情况下
custom
用作运算符。
dynamic
Criteria
集中要应用于此列的动态条件
ExcelScript.DynamicFilterCriteria
。 用于
dynamic
筛选。
filter
On
筛选器使用的属性，用于确定是否应将值保持为可见时。
用于筛选单元格的图标。 用于
icon
筛选。
operator
使用筛选时，用于组合条件 1 和 2 的
custom
运算符。
sub
Field
筛选器用于对富值执行丰富筛选的属性。
values
要用作筛选一部分的值
values
集。
第一个条件用于筛选数据。 在筛选的情况下
custom
用作运算符。 例如，“
>
50”表示大于 50 的数字，或者“=*s”表示以“s”结尾的值。
在顶部/底部项目/百分比 (情况下用作数字，例如，如果
filterOn
设置为
topItems
) ，则为前 5 个项目的“5”。
criterion1?: string;
string
* This script creates an autoFilter on the worksheet that filters out rows based on column values.
* The autoFilter filters to only include rows that have a value in column C in the lowest 10 values
* (of column C values).
function main(workbook: ExcelScript.Workbook) {
const currentSheet = workbook.getActiveWorksheet();
const dataRange = currentSheet.getUsedRange();
// Add a filter that will only show the rows with the lowest 10 values in column C
// (index 2, assuming the used range spans from at least A:C).
const filterCriteria: ExcelScript.FilterCriteria = {
criterion1: "10",
filterOn: ExcelScript.FilterOn.bottomItems
currentSheet.getAutoFilter().apply(dataRange, 2, filterCriteria);
* This script applies a filter to a table so that it only shows rows with "Needs Review" in the "Type" column.
function main(workbook: ExcelScript.Workbook) {
// Get the first table in the workbook.
const table = workbook.getTables()[0];
// Apply the filter to the "Type" column.
const typeColumn = table.getColumnByName("Type");
typeColumn.getFilter().applyValuesFilter(["Needs Review"]);
