Partager via


ExcelScript.ValueFilterCondition enum

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

Remarques

Exemples

/**
 * This script applies a PivotValueFilter to the first row hierarchy in the PivotTable.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the PivotTable on the current worksheet.
  let sheet = workbook.getActiveWorksheet();
  let pivotTable = sheet.getPivotTables()[0];

  // Get the first row hierarchy to use as the field which gets filtered.
  let rowHierarchy = pivotTable.getRowHierarchies()[0];

  // Get the first data hierarchy to use as the values for filtering the rows.
  let dataHierarchy = pivotTable.getDataHierarchies()[0];

  // Create a filter that excludes values greater than 500.
  let filter: ExcelScript.PivotValueFilter = {
    condition: ExcelScript.ValueFilterCondition.greaterThan,
    comparator: 500,
    value: dataHierarchy.getName()
  };

  // Apply the filter.
  rowHierarchy.getPivotField(rowHierarchy.getName()).applyFilter({
    valueFilter: filter
  });
}

Champs

between

Entre lowerBound les critères et upperBound .

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

bottomN

Dans le N inférieur (threshold) [éléments, pourcentage, somme] de la catégorie de valeur.

Critères requis : {value, threshold, selectionType}.

equals

Est égal au critère de comparateur.

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

greaterThan

Supérieur au critère de comparateur.

Critères requis : {value, comparator}.

greaterThanOrEqualTo

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

Critères requis : {value, comparator}.

lessThan

Critère inférieur à celui du comparateur.

Critères requis : {value, comparator}.

lessThanOrEqualTo

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

Critères requis : {value, comparator}.

topN

Dans les N premiers (threshold) [éléments, pourcentage, somme] de la catégorie de valeur.

Critères requis : {value, threshold, selectionType}.

unknown

ValueFilterCondition est inconnu ou non pris en charge.