ExcelScript.ConditionalIconCriterion interface

Pacote:

ExcelScript

Representa um critério de ícone que contém um tipo, um valor, um operador e um ícone personalizado opcional, se não estiver usando um conjunto de ícones.

Comentários

Exemplos

/**
 * This script applies icon set conditional formatting to a range.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range "A1:A5" on the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const range = sheet.getRange("A1:A5");

  // Create icon set conditional formatting on the range.
  const conditionalFormatting = range.addConditionalFormat(ExcelScript.ConditionalFormatType.iconSet);

  // Use the "3 Traffic Lights (Unrimmed)" set.
  conditionalFormatting.getIconSet().setStyle(ExcelScript.IconSet.threeTrafficLights1);

  // Set the criteria to use a different icon for the bottom, middle, and top thirds of the values in the range.
  const criteria: ExcelScript.ConditionalIconCriterion[] = [
    {
      formula: '=0', operator: ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type: ExcelScript.ConditionalFormatIconRuleType.percent
    },
    {
      formula: '=33', operator: ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type: ExcelScript.ConditionalFormatIconRuleType.percent
    },
    {
      formula: '=67', operator: ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
      type: ExcelScript.ConditionalFormatIconRuleType.percent
    }];
  conditionalFormatting.getIconSet().setCriteria(criteria);
}

Propriedades

customIcon	O ícone personalizado para o critério atual, se diferente do conjunto de ícones padrão, o restante null será retornado.
formula	Um número ou uma fórmula, dependendo do tipo.
operator	greaterThan ou greaterThanOrEqual para cada um dos tipos de regra para o formato condicional de ícone.
type	No que a fórmula condicional de ícone deve se basear.

Detalhes da propriedade

customIcon

O ícone personalizado para o critério atual, se diferente do conjunto de ícones padrão, o restante null será retornado.

customIcon?: Icon;

Valor da propriedade

ExcelScript.Icon

formula

Um número ou uma fórmula, dependendo do tipo.

formula: string;

Valor da propriedade

string

operator

greaterThan ou greaterThanOrEqual para cada um dos tipos de regra para o formato condicional de ícone.

operator: ConditionalIconCriterionOperator;

Valor da propriedade

ExcelScript.ConditionalIconCriterionOperator

type

No que a fórmula condicional de ícone deve se basear.

type: ConditionalFormatIconRuleType;

Valor da propriedade

ExcelScript.ConditionalFormatIconRuleType