Excel.PivotLabelFilter interface
Konfigurierbare Vorlage für einen Bezeichnungsfilter, der auf ein PivotField angewendet werden soll. Definiert condition , welche Kriterien festgelegt werden müssen, damit der Filter funktioniert.
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-pivotfilters.yaml
await Excel.run(async (context) => {
// Add a PivotFilter to filter based on the strings of item labels.
// Get the PivotTable.
const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");
// Get the "Type" field.
const field = pivotTable.hierarchies.getItem("Type").fields.getItem("Type");
// Filter out any types that start with "L" ("Lemons" and "Limes" in this case).
const filter: Excel.PivotLabelFilter = {
condition: Excel.LabelFilterCondition.beginsWith,
substring: "L",
exclusive: true
};
// Apply the label filter to the field.
field.applyFilter({ labelFilter: filter });
await context.sync();
});
Eigenschaften
| comparator | Der Vergleichsparameter ist der statische Wert, mit dem andere Werte verglichen werden. Der Vergleichstyp wird durch die Bedingung definiert. Hinweis: Eine numerische Zeichenfolge wird als Zahl behandelt, wenn sie mit anderen numerischen Zeichenfolgen verglichen wird. |
| condition | Gibt die Bedingung für den Filter an, der die erforderlichen Filterkriterien definiert. |
| exclusive | Wenn |
| lower |
Die untere Grenze des Bereichs für die |
| substring | Die Teilzeichenfolge, die für die |
| upper |
Die obere Grenze des Bereichs für die |
Details zur Eigenschaft
comparator
Der Vergleichsparameter ist der statische Wert, mit dem andere Werte verglichen werden. Der Vergleichstyp wird durch die Bedingung definiert. Hinweis: Eine numerische Zeichenfolge wird als Zahl behandelt, wenn sie mit anderen numerischen Zeichenfolgen verglichen wird.
comparator?: string;Eigenschaftswert
string
Hinweise
condition
Gibt die Bedingung für den Filter an, der die erforderlichen Filterkriterien definiert.
condition: Excel.LabelFilterCondition | "Unknown" | "Equals" | "BeginsWith" | "EndsWith" | "Contains" | "GreaterThan" | "GreaterThanOrEqualTo" | "LessThan" | "LessThanOrEqualTo" | "Between";Eigenschaftswert
Excel.LabelFilterCondition | "Unknown" | "Equals" | "BeginsWith" | "EndsWith" | "Contains" | "GreaterThan" | "GreaterThanOrEqualTo" | "LessThan" | "LessThanOrEqualTo" | "Between"
Hinweise
exclusive
Wenn true, schließt filter Elemente aus , die Kriterien erfüllen. Der Standardwert ist false (Filter, um Elemente einzuschließen, die Kriterien erfüllen).
exclusive?: boolean;Eigenschaftswert
boolean
Hinweise
lowerBound
Die untere Grenze des Bereichs für die between Filterbedingung. Hinweis: Eine numerische Zeichenfolge wird als Zahl behandelt, wenn sie mit anderen numerischen Zeichenfolgen verglichen wird.
lowerBound?: string;Eigenschaftswert
string
Hinweise
substring
Die Teilzeichenfolge, die für die beginsWithFilterbedingungen , endsWithund contains verwendet wird.
substring?: string;Eigenschaftswert
string
Hinweise
upperBound
Die obere Grenze des Bereichs für die between Filterbedingung. Hinweis: Eine numerische Zeichenfolge wird als Zahl behandelt, wenn sie mit anderen numerischen Zeichenfolgen verglichen wird.
upperBound?: string;Eigenschaftswert
string