Excel.ValueFilterCondition enum

表示可应用值筛选器的所有接受条件的枚举。 用于配置应用于字段的 PivotFilter 的类型。 PivotFilter.exclusive 可以设置为 以 true 反转其中许多条件。

注解

[ API 集:ExcelApi 1.12 ]

示例

// 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 on the values correlated with a row.

  // Get the PivotTable.
  const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");

  // Get the "Farm" field.
  const field = pivotTable.hierarchies.getItem("Farm").fields.getItem("Farm");

  // Filter to only include rows with more than 500 wholesale crates sold.
  const filter: Excel.PivotValueFilter = {
    condition: Excel.ValueFilterCondition.greaterThan,
    comparator: 500,
    value: "Sum of Crates Sold Wholesale"
  };

  // Apply the value filter to the field.
  field.applyFilter({ valueFilter: filter });

  await context.sync();
});

字段

between = "Between"

在 和 upperBound 条件之间lowerBound

必需条件: {valuelowerBoundupperBound}。 可选条件:{exclusive}

bottomN = "BottomN"

在底部 N (threshold) 值类别的 [items, percent, sum] 。

必需条件: {valuethresholdselectionType}

equals = "Equals"

等于比较器条件。

必需条件: {valuecomparator}。 可选条件:{exclusive}

greaterThan = "GreaterThan"

大于比较器条件。

必需条件: {valuecomparator}

greaterThanOrEqualTo = "GreaterThanOrEqualTo"

大于或等于比较器条件。

必需条件: {valuecomparator}

lessThan = "LessThan"

小于比较器条件。

必需条件: {valuecomparator}

lessThanOrEqualTo = "LessThanOrEqualTo"

小于或等于比较器条件。

必需条件: {valuecomparator}

topN = "TopN"

在前 N 个 (threshold) 值类别的 [items, percent, sum]。

必需条件: {valuethresholdselectionType}

unknown = "Unknown"

ValueFilterCondition 未知或不受支持。