Excel.FilterCriteria interface
Stellt die auf eine Spalte angewendeten Filterkriterien dar.
Hinweise
Eigenschaften
color | Die HTML-Farbzeichenfolge, die zum Filtern von Zellen verwendet wird. Wird mit |
criterion1 | Das erste verwendete Kriterium zum Filtern von Daten. Wird beim Filtern als Operator Wird als Zahl im Fall der obersten/unteren Elemente/Prozentsätze verwendet (z. B. "5" für die obersten 5 Elemente, wenn |
criterion2 | Das zweite verwendete Kriterium zum Filtern von Daten. Wird nur als Operator im Fall der |
dynamic |
Die dynamischen Kriterien aus dem Satz, die |
filter |
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 |
operator | Der Operator, der verwendet wird, um kriterium 1 und 2 bei Verwendung von |
sub |
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 |
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
Hinweise
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 topItems
festgelegt ist).
criterion1?: string;
Eigenschaftswert
string
Hinweise
criterion2
Das zweite verwendete Kriterium zum Filtern von Daten. Wird nur als Operator im Fall der custom
Filterung verwendet.
criterion2?: string;
Eigenschaftswert
string
Hinweise
dynamicCriteria
Die dynamischen Kriterien aus dem Satz, die Excel.DynamicFilterCriteria
auf diese Spalte angewendet werden sollen. Wird mit dynamic
Filterung verwendet.
dynamicCriteria?: Excel.DynamicFilterCriteria | "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" | "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember" | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary" | "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" | "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" | "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" | "AllDatesInPeriodQuarter1" | "AllDatesInPeriodQuarter2" | "AllDatesInPeriodQuarter3" | "AllDatesInPeriodQuarter4" | "AllDatesInPeriodSeptember" | "BelowAverage" | "LastMonth" | "LastQuarter" | "LastWeek" | "LastYear" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" | "ThisQuarter" | "ThisWeek" | "ThisYear" | "Today" | "Tomorrow" | "YearToDate" | "Yesterday";
Eigenschaftswert
Excel.DynamicFilterCriteria | "Unknown" | "AboveAverage" | "AllDatesInPeriodApril" | "AllDatesInPeriodAugust" | "AllDatesInPeriodDecember" | "AllDatesInPeriodFebruray" | "AllDatesInPeriodJanuary" | "AllDatesInPeriodJuly" | "AllDatesInPeriodJune" | "AllDatesInPeriodMarch" | "AllDatesInPeriodMay" | "AllDatesInPeriodNovember" | "AllDatesInPeriodOctober" | "AllDatesInPeriodQuarter1" | "AllDatesInPeriodQuarter2" | "AllDatesInPeriodQuarter3" | "AllDatesInPeriodQuarter4" | "AllDatesInPeriodSeptember" | "BelowAverage" | "LastMonth" | "LastQuarter" | "LastWeek" | "LastYear" | "NextMonth" | "NextQuarter" | "NextWeek" | "NextYear" | "ThisMonth" | "ThisQuarter" | "ThisWeek" | "ThisYear" | "Today" | "Tomorrow" | "YearToDate" | "Yesterday"
Hinweise
filterOn
Die Eigenschaft, die vom Filter verwendet wird, um zu bestimmen, ob die Werte sichtbar bleiben sollen.
filterOn: Excel.FilterOn | "BottomItems" | "BottomPercent" | "CellColor" | "Dynamic" | "FontColor" | "Values" | "TopItems" | "TopPercent" | "Icon" | "Custom";
Eigenschaftswert
Excel.FilterOn | "BottomItems" | "BottomPercent" | "CellColor" | "Dynamic" | "FontColor" | "Values" | "TopItems" | "TopPercent" | "Icon" | "Custom"
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-auto-filter.yaml
// This function adds a percentage AutoFilter to the active worksheet
// and applies the filter to a column of the used range.
await Excel.run(async (context) => {
// Retrieve the active worksheet and the used range on that worksheet.
const sheet = context.workbook.worksheets.getActiveWorksheet();
const farmData = sheet.getUsedRange();
// Add a filter that will only show the rows with the top 50% of values in column 3.
sheet.autoFilter.apply(farmData, 3, {
criterion1: "50",
filterOn: Excel.FilterOn.topPercent
});
await context.sync();
});
icon
Das zum Filtern von Zellen verwendete Symbol. Wird mit icon
Filterung verwendet.
icon?: Excel.Icon;
Eigenschaftswert
Hinweise
operator
Der Operator, der verwendet wird, um kriterium 1 und 2 bei Verwendung von custom
Filterung zu kombinieren.
operator?: Excel.FilterOperator | "And" | "Or";
Eigenschaftswert
Excel.FilterOperator | "And" | "Or"
Hinweise
subField
Die Eigenschaft, die vom Filter verwendet wird, um einen umfangreichen Filter für Rich-Werte zu erstellen.
subField?: string;
Eigenschaftswert
string
Hinweise
values
Der Satz von Werten, die als Teil der values
Filterung verwendet werden sollen.
values?: Array<string | FilterDatetime>;
Eigenschaftswert
Array<string | Excel.FilterDatetime>
Hinweise
Office Add-ins