ExcelScript.ConditionalIconCriterion interface

Pacote:

ExcelScript

Representa um critério de ícone que contém um tipo, valor, um operador e um ícone personalizado opcional, se não utilizar 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 predefinido, será devolvido.null
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 do í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 predefinido, será devolvido.null

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 do í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