ExcelScript.ConditionalIconCriterion interface

Paquet:

ExcelScript

Représente un critère d’icône qui contient un type, une valeur, un opérateur et une icône personnalisée facultative, s’il n’utilise pas un jeu d’icônes.

Remarques

Exemples

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

Propriétés

customIcon	L’icône personnalisée pour le critère actuel, si différente de l’ensemble d’icônes par défaut, est null retournée.
formula	Un nombre ou une formule en fonction du type.
operator	greaterThan ou greaterThanOrEqual pour chacun des types de règles pour le format conditionnel d’icône.
type	Ce sur quoi la formule conditionnelle de l’icône doit être basée.

Détails de la propriété

customIcon

L’icône personnalisée pour le critère actuel, si différente de l’ensemble d’icônes par défaut, est null retournée.

customIcon?: Icon;

Valeur de propriété

ExcelScript.Icon

formula

Un nombre ou une formule en fonction du type.

formula: string;

Valeur de propriété

string

operator

greaterThan ou greaterThanOrEqual pour chacun des types de règles pour le format conditionnel d’icône.

operator: ConditionalIconCriterionOperator;

Valeur de propriété

ExcelScript.ConditionalIconCriterionOperator

type

Ce sur quoi la formule conditionnelle de l’icône doit être basée.

type: ConditionalFormatIconRuleType;

Valeur de propriété

ExcelScript.ConditionalFormatIconRuleType