Compartilhar via


ExcelScript.FilterCriteria interface

Representa os critérios de filtragem aplicados a uma coluna.

Propriedades

color

A cadeia HTML de cor usada para filtrar células. Utilizado com cellColor e fontColor filtragem.

criterion1

O primeiro critério usado para filtrar os dados. Utilizado como operador no caso da custom filtragem. Por exemplo, ">50" para números superiores a 50 ou "=*s" para valores que terminem em "s".

Utilizado como um número no caso de itens/percentagens superiores/inferiores (por exemplo, "5" para os 5 principais itens, se filterOn estiver definido como topItems).

criterion2

O segundo critério usado para filtrar os dados. Utilizado apenas como operador no caso da custom filtragem.

dynamicCriteria

Os critérios dinâmicos do ExcelScript.DynamicFilterCriteria conjunto a aplicar nesta coluna. Utilizado com dynamic filtragem.

filterOn

A propriedade usada pelo filtro para determinar se os valores devem ficar visíveis.

icon

O ícone usado para filtrar células. Utilizado com icon filtragem.

operator

O operador utilizado para combinar critérios 1 e 2 ao utilizar custom a filtragem.

subField

A propriedade utilizada pelo filtro para efetuar um filtro avançado em valores avançados.

values

O conjunto de valores a utilizar como parte da values filtragem.

Detalhes da propriedade

color

A cadeia HTML de cor usada para filtrar células. Utilizado com cellColor e fontColor filtragem.

color?: string;

Valor da propriedade

string

criterion1

O primeiro critério usado para filtrar os dados. Utilizado como operador no caso da custom filtragem. Por exemplo, ">50" para números superiores a 50 ou "=*s" para valores que terminem em "s".

Utilizado como um número no caso de itens/percentagens superiores/inferiores (por exemplo, "5" para os 5 principais itens, se filterOn estiver definido como topItems).

criterion1?: string;

Valor da propriedade

string

Exemplos

/**
 * 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

O segundo critério usado para filtrar os dados. Utilizado apenas como operador no caso da custom filtragem.

criterion2?: string;

Valor da propriedade

string

dynamicCriteria

Os critérios dinâmicos do ExcelScript.DynamicFilterCriteria conjunto a aplicar nesta coluna. Utilizado com dynamic filtragem.

dynamicCriteria?: DynamicFilterCriteria;

Valor da propriedade

filterOn

A propriedade usada pelo filtro para determinar se os valores devem ficar visíveis.

filterOn: FilterOn;

Valor da propriedade

icon

O ícone usado para filtrar células. Utilizado com icon filtragem.

icon?: Icon;

Valor da propriedade

operator

O operador utilizado para combinar critérios 1 e 2 ao utilizar custom a filtragem.

operator?: FilterOperator;

Valor da propriedade

subField

A propriedade utilizada pelo filtro para efetuar um filtro avançado em valores avançados.

subField?: string;

Valor da propriedade

string

values

O conjunto de valores a utilizar como parte da values filtragem.

values?: Array<string | FilterDatetime>;

Valor da propriedade

Array<string | ExcelScript.FilterDatetime>