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 |
criterion1 | O primeiro critério usado para filtrar os dados. Utilizado como operador no caso da Utilizado como um número no caso de itens/percentagens superiores/inferiores (por exemplo, "5" para os 5 principais itens, se |
criterion2 | O segundo critério usado para filtrar os dados. Utilizado apenas como operador no caso da |
dynamic |
Os critérios dinâmicos do |
filter |
A propriedade usada pelo filtro para determinar se os valores devem ficar visíveis. |
icon | O ícone usado para filtrar células. Utilizado com |
operator | O operador utilizado para combinar critérios 1 e 2 ao utilizar |
sub |
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 |
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>