Compartilhar via


Excel.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

[ Conjunto de API: ExcelApi 1.12 ]

Exemplos

// 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 on the values correlated with a row.

  // Get the PivotTable.
  const pivotTable = context.workbook.worksheets.getActiveWorksheet().pivotTables.getItem("Farm Sales");

  // Get the "Farm" field.
  const field = pivotTable.hierarchies.getItem("Farm").fields.getItem("Farm");

  // Filter to only include rows with more than 500 wholesale crates sold.
  const filter: Excel.PivotValueFilter = {
    condition: Excel.ValueFilterCondition.greaterThan,
    comparator: 500,
    value: "Sum of Crates Sold Wholesale"
  };

  // Apply the value filter to the field.
  field.applyFilter({ valueFilter: filter });

  await context.sync();
});

Campos

between = "Between"

Entre lowerBound critérios e upperBound .

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

bottomN = "BottomN"

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

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

equals = "Equals"

É igual ao critério do comparador.

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

greaterThan = "GreaterThan"

Critério maior do que o comparador.

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

greaterThanOrEqualTo = "GreaterThanOrEqualTo"

Maior ou igual ao critério do comparador.

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

lessThan = "LessThan"

Menos do que o critério do comparador.

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

lessThanOrEqualTo = "LessThanOrEqualTo"

Menor ou igual ao critério do comparador.

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

topN = "TopN"

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

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

unknown = "Unknown"

ValueFilterCondition é desconhecido ou não é suportado.