Excel.LabelFilterCondition enum

Énumération représentant toutes les conditions acceptées par lesquelles un filtre d’étiquette peut être appliqué. Permet de configurer le type de filtre croisé dynamique appliqué au champ. PivotFilter.criteria.exclusive peut être définie pour true inverser bon nombre de ces conditions.

Remarques

Jeu d’API : ExcelApi 1.12

Utilisateur

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 et upperBound critères.

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"

Équivaut au critère de comparaison.

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

greaterThan = "GreaterThan"

Supérieur au critère de comparaison.

Critères requis : {comparator}.

greaterThanOrEqualTo = "GreaterThanOrEqualTo"

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

Critères requis : {comparator}.

lessThan = "LessThan"

Inférieur au critère de comparaison.

Critères requis : {comparator}.

lessThanOrEqualTo = "LessThanOrEqualTo"

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

Critères requis : {comparator}.

unknown = "Unknown"

LabelFilterCondition est inconnu ou non pris en charge.