ExcelScript.FilterCriteria interface

Paket:

ExcelScript

Stellt die auf eine Spalte angewendeten Filterkriterien dar.

Eigenschaften

color	Die HTML-Farbzeichenfolge, die zum Filtern von Zellen verwendet wird. Wird mit cellColor und fontColor Filterung verwendet.
criterion1	Das erste verwendete Kriterium zum Filtern von Daten. Wird beim Filtern als Operator custom verwendet. Beispiel: ">50" für Zahlen größer als 50 oder "=*s" für Werte, die mit "s" enden. Wird als Zahl im Fall der obersten/unteren Elemente/Prozentsätze verwendet (z. B. "5" für die obersten 5 Elemente, wenn filterOn auf topItemsfestgelegt ist).
criterion2	Das zweite verwendete Kriterium zum Filtern von Daten. Wird nur als Operator im Fall der custom Filterung verwendet.
dynamicCriteria	Die dynamischen Kriterien aus dem Satz, die ExcelScript.DynamicFilterCriteria auf diese Spalte angewendet werden sollen. Wird mit dynamic Filterung verwendet.
filterOn	Die Eigenschaft, die vom Filter verwendet wird, um zu bestimmen, ob die Werte sichtbar bleiben sollen.
icon	Das zum Filtern von Zellen verwendete Symbol. Wird mit icon Filterung verwendet.
operator	Der Operator, der verwendet wird, um kriterium 1 und 2 bei Verwendung von custom Filterung zu kombinieren.
subField	Die Eigenschaft, die vom Filter verwendet wird, um einen umfangreichen Filter für Rich-Werte zu erstellen.
values	Der Satz von Werten, die als Teil der values Filterung verwendet werden sollen.

Details zur Eigenschaft

color

Die HTML-Farbzeichenfolge, die zum Filtern von Zellen verwendet wird. Wird mit cellColor und fontColor Filterung verwendet.

color?: string;

Eigenschaftswert

string

criterion1

Das erste verwendete Kriterium zum Filtern von Daten. Wird beim Filtern als Operator custom verwendet. Beispiel: ">50" für Zahlen größer als 50 oder "=*s" für Werte, die mit "s" enden.

Wird als Zahl im Fall der obersten/unteren Elemente/Prozentsätze verwendet (z. B. "5" für die obersten 5 Elemente, wenn filterOn auf topItemsfestgelegt ist).

criterion1?: string;

Eigenschaftswert

string

Beispiele

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

Das zweite verwendete Kriterium zum Filtern von Daten. Wird nur als Operator im Fall der custom Filterung verwendet.

criterion2?: string;

Eigenschaftswert

string

dynamicCriteria

Die dynamischen Kriterien aus dem Satz, die ExcelScript.DynamicFilterCriteria auf diese Spalte angewendet werden sollen. Wird mit dynamic Filterung verwendet.

dynamicCriteria?: DynamicFilterCriteria;

Eigenschaftswert

ExcelScript.DynamicFilterCriteria

filterOn

Die Eigenschaft, die vom Filter verwendet wird, um zu bestimmen, ob die Werte sichtbar bleiben sollen.

filterOn: FilterOn;

Eigenschaftswert

ExcelScript.FilterOn

icon

Das zum Filtern von Zellen verwendete Symbol. Wird mit icon Filterung verwendet.

icon?: Icon;

Eigenschaftswert

ExcelScript.Icon

operator

Der Operator, der verwendet wird, um kriterium 1 und 2 bei Verwendung von custom Filterung zu kombinieren.

operator?: FilterOperator;

Eigenschaftswert

ExcelScript.FilterOperator

subField

Die Eigenschaft, die vom Filter verwendet wird, um einen umfangreichen Filter für Rich-Werte zu erstellen.

subField?: string;

Eigenschaftswert

string

values

Der Satz von Werten, die als Teil der values Filterung verwendet werden sollen.

values?: Array<string | FilterDatetime>;

Eigenschaftswert

Array<string | ExcelScript.FilterDatetime>