Freigeben über


ExcelScript.PivotManualFilter interface

Konfigurierbare Vorlage für einen manuellen Filter, der auf ein PivotField angewendet werden soll. Definiert condition , welche Kriterien festgelegt werden müssen, damit der Filter funktioniert.

Hinweise

Beispiele

/**
 * This script adds a manual filter to a PivotTable. 
 */
function main(workbook: ExcelScript.Workbook)
{
  // Get the first PivotTable in the workbook.
  const pivot = workbook.getPivotTables()[0];

  // Get the hierarchy to use as the filter.
  const location = pivot.getHierarchy("Location");

  // Use "Location" as the FilterHierarchy.
  pivot.addFilterHierarchy(location);

  // Select items for the filter.
  const cityFilter: ExcelScript.PivotManualFilter = {
    selectedItems: ["Seattle", "Chicago"]
  };

  // Apply the filter
  // Note that hierarchies and fields have a 1:1 relationship in Excel, so `getFields()[0]` always gets the correct field.
  location.getFields()[0].applyFilter({
    manualFilter: cityFilter
  });
}

Eigenschaften

selectedItems

Eine Liste ausgewählter Elemente, die manuell gefiltert werden sollen. Dies müssen vorhandene und gültige Elemente aus dem ausgewählten Feld sein.

Details zur Eigenschaft

selectedItems

Eine Liste ausgewählter Elemente, die manuell gefiltert werden sollen. Dies müssen vorhandene und gültige Elemente aus dem ausgewählten Feld sein.

selectedItems?: (string | PivotItem)[];

Eigenschaftswert

(string | ExcelScript.PivotItem)[]