Excel.LabelFilterCondition enum

  • 参考
包:
excel

表示可应用标签筛选器的所有接受条件的枚举。 用于配置应用于字段的 PivotFilter 的类型。 PivotFilter.criteria.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 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();
});

字段

beginsWith = "BeginsWith"

标签以子字符串条件开头。

必需条件：{substring}。 可选条件：{exclusive}。
between = "Between"

在 和 upperBound 条件之间lowerBound。

必需条件： {lowerBound， upperBound}。 可选条件：{exclusive}。
contains = "Contains"

标签包含子字符串条件。

必需条件：{substring}。 可选条件：{exclusive}。
endsWith = "EndsWith"

标签以子字符串条件结尾。

必需条件：{substring}。 可选条件：{exclusive}。
equals = "Equals"

等于比较器条件。

必需条件：{comparator}。 可选条件：{exclusive}。
greaterThan = "GreaterThan"

大于比较器条件。

必需条件：{comparator}。
greaterThanOrEqualTo = "GreaterThanOrEqualTo"

大于或等于比较器条件。

必需条件：{comparator}。
lessThan = "LessThan"

小于比较器条件。

必需条件：{comparator}。
lessThanOrEqualTo = "LessThanOrEqualTo"

小于或等于比较器条件。

必需条件：{comparator}。
unknown = "Unknown"

LabelFilterCondition 未知或不受支持。