ExcelScript.PivotManualFilter interface

用于应用于 PivotField 的手动筛选器的可配置模板。 定义 condition 需要设置哪些条件才能使筛选器运行。

注解

示例

/**
 * 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
  });
}

属性

selectedItems

要手动筛选的选定项的列表。 这些项必须是所选字段中的现有有效项。

属性详细信息

selectedItems

要手动筛选的选定项的列表。 这些项必须是所选字段中的现有有效项。

selectedItems?: (string | PivotItem)[];

属性值

(string | ExcelScript.PivotItem)[]