Partager via


Excel.LabelFilterCondition enum

Enum représentant toutes les conditions acceptées par lesquelles un filtre d’étiquette peut être appliqué. Permet de configurer le type de PivotFilter appliqué au champ. PivotFilter.criteria.exclusive peut être défini sur true pour inverser la plupart de ces conditions.

Remarques

[ Ensemble d’API : ExcelApi 1.12 ]

Exemples

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

Champs

beginsWith = "BeginsWith"

L’étiquette commence par le critère de sous-chaîne.

Critères requis : {substring}. Critères facultatifs : {exclusive}.

between = "Between"

Entre lowerBound les critères et upperBound .

Critères requis : {lowerBound, upperBound}. Critères facultatifs : {exclusive}.

contains = "Contains"

L’étiquette contient le critère de sous-chaîne.

Critères requis : {substring}. Critères facultatifs : {exclusive}.

endsWith = "EndsWith"

L’étiquette se termine par le critère de sous-chaîne.

Critères requis : {substring}. Critères facultatifs : {exclusive}.

equals = "Equals"

Est égal au critère de comparateur.

Critères requis : {comparator}. Critères facultatifs : {exclusive}.

greaterThan = "GreaterThan"

Supérieur au critère de comparateur.

Critères requis : {comparator}.

greaterThanOrEqualTo = "GreaterThanOrEqualTo"

Supérieur ou égal au critère de comparaison.

Critères requis : {comparator}.

lessThan = "LessThan"

Critère inférieur à celui du comparateur.

Critères requis : {comparator}.

lessThanOrEqualTo = "LessThanOrEqualTo"

Inférieur ou égal au critère de comparateur.

Critères requis : {comparator}.

unknown = "Unknown"

LabelFilterCondition est inconnu ou non pris en charge.