ExcelScript.FilterCriteria interface

包:

ExcelScript

表示应用于列的筛选条件。

属性

color	用于筛选单元格的 HTML 颜色字符串。 与 和 fontColor 筛选一起使用cellColor。
criterion1	第一个条件用于筛选数据。 在筛选的情况下 custom 用作运算符。 例如，“>50”表示大于 50 的数字，或者“=*s”表示以“s”结尾的值。 在顶部/底部项目/百分比 (情况下用作数字，例如，如果 filterOn 设置为 topItems) ，则为前 5 个项目的“5”。
criterion2	第二个条件用于筛选数据。 仅在筛选的情况下 custom 用作运算符。
dynamicCriteria	集中要应用于此列的动态条件 ExcelScript.DynamicFilterCriteria 。 用于 dynamic 筛选。
filterOn	筛选器使用的属性，用于确定是否应将值保持为可见时。
icon	用于筛选单元格的图标。 用于 icon 筛选。
operator	使用筛选时，用于组合条件 1 和 2 的 custom 运算符。
subField	筛选器用于对富值执行丰富筛选的属性。
values	要用作筛选一部分的值 values 集。

属性详细信息

color

用于筛选单元格的 HTML 颜色字符串。 与 和 fontColor 筛选一起使用cellColor。

color?: string;

属性值

string

criterion1

第一个条件用于筛选数据。 在筛选的情况下 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);
}

criterion2

第二个条件用于筛选数据。 仅在筛选的情况下 custom 用作运算符。

criterion2?: string;

属性值

string

dynamicCriteria

集中要应用于此列的动态条件 ExcelScript.DynamicFilterCriteria 。 用于 dynamic 筛选。

dynamicCriteria?: DynamicFilterCriteria;

属性值

ExcelScript.DynamicFilterCriteria

filterOn

筛选器使用的属性，用于确定是否应将值保持为可见时。

filterOn: FilterOn;

属性值

ExcelScript.FilterOn

icon

用于筛选单元格的图标。 用于 icon 筛选。

icon?: Icon;

属性值

ExcelScript.Icon

operator

使用筛选时，用于组合条件 1 和 2 的 custom 运算符。

operator?: FilterOperator;

属性值

ExcelScript.FilterOperator

subField

筛选器用于对富值执行丰富筛选的属性。

subField?: string;

属性值

string

values

要用作筛选一部分的值 values 集。

values?: Array<string | FilterDatetime>;

属性值

Array<string | ExcelScript.FilterDatetime>