ExcelScript.ConditionalIconCriterion interface

Paquete:

ExcelScript

Representa un criterio de icono que contiene un tipo, un valor, un operador y un icono personalizado opcional, si no usa un conjunto de iconos.

Comentarios

Ejemplos

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

Propiedades

customIcon	El icono personalizado para el criterio actual, si es diferente del conjunto de iconos predeterminado, se devolverá.null
formula	Número o fórmula en función del tipo.
operator	greaterThan o greaterThanOrEqual para cada uno de los tipos de regla para el formato condicional de icono.
type	Elemento en el que se debe basar la fórmula condicional de icono.

Detalles de las propiedades

customIcon

El icono personalizado para el criterio actual, si es diferente del conjunto de iconos predeterminado, se devolverá.null

customIcon?: Icon;

Valor de propiedad

ExcelScript.Icon

formula

Número o fórmula en función del tipo.

formula: string;

Valor de propiedad

string

operator

greaterThan o greaterThanOrEqual para cada uno de los tipos de regla para el formato condicional de icono.

operator: ConditionalIconCriterionOperator;

Valor de propiedad

ExcelScript.ConditionalIconCriterionOperator

type

Elemento en el que se debe basar la fórmula condicional de icono.

type: ConditionalFormatIconRuleType;

Valor de propiedad

ExcelScript.ConditionalFormatIconRuleType