Compartilhar via


ExcelScript.ValueFilterCondition enum

Enumeração que representa todas as condições aceites através das quais um filtro de valor pode ser aplicado. Utilizado para configurar o tipo de PivotFilter aplicado ao campo. PivotFilter.exclusive pode ser definido como true para inverter muitas destas condições.

Comentários

Exemplos

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

Campos

between

Entre lowerBound critérios e upperBound .

Critérios Obrigatórios: {value, lowerBound, upperBound}. Critérios Opcionais: {exclusive}.

bottomN

Na parte inferior N (threshold) [itens, percentagem, soma] da categoria de valor.

Critérios Obrigatórios: {value, threshold, selectionType}.

equals

É igual ao critério do comparador.

Critérios Obrigatórios: {value, comparator}. Critérios Opcionais: {exclusive}.

greaterThan

Critério maior do que o comparador.

Critérios Obrigatórios: {value, comparator}.

greaterThanOrEqualTo

Maior ou igual ao critério do comparador.

Critérios Obrigatórios: {value, comparator}.

lessThan

Menos do que o critério do comparador.

Critérios Obrigatórios: {value, comparator}.

lessThanOrEqualTo

Menor ou igual ao critério do comparador.

Critérios Obrigatórios: {value, comparator}.

topN

Na parte superior N (threshold) [itens, percentagem, soma] da categoria de valor.

Critérios Obrigatórios: {value, threshold, selectionType}.

unknown

ValueFilterCondition é desconhecido ou não é suportado.