ExcelScript.IconSetConditionalFormat interface

Paquet:

ExcelScript

Représente un jeu d’icônes critères pour la mise en forme conditionnelle.

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);
  const iconSetFormat: ExcelScript.IconSetConditionalFormat = conditionalFormatting.getIconSet();
  // Use the "3 Traffic Lights (Unrimmed)" set.
  iconSetFormat.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.
  iconSetFormat.setCriteria([
    {
      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
    }]);
}

Méthodes

getCriteria()	Tableau de critères et jeux d’icônes pour les règles et icônes personnalisées potentielles pour les icônes conditionnelles. Notez que pour le premier critère, seule l’icône personnalisée peut être modifiée, tandis que le type, la formule et l’opérateur sont ignorés lorsqu’ils sont définis.
getReverseIconOrder()	Si truela valeur est , inverse les ordres d’icônes pour le jeu d’icônes. Notez que cela ne peut pas être défini si des icônes personnalisées sont utilisées.
getShowIconOnly()	Si truela valeur est , masque les valeurs et affiche uniquement les icônes.
getStyle()	Si cette option est définie, affiche l’option jeu d’icônes pour le format conditionnel.
setCriteria(criteria)	Tableau de critères et jeux d’icônes pour les règles et icônes personnalisées potentielles pour les icônes conditionnelles. Notez que pour le premier critère, seule l’icône personnalisée peut être modifiée, tandis que le type, la formule et l’opérateur sont ignorés lorsqu’ils sont définis.
setReverseIconOrder(reverseIconOrder)	Si truela valeur est , inverse les ordres d’icônes pour le jeu d’icônes. Notez que cela ne peut pas être défini si des icônes personnalisées sont utilisées.
setShowIconOnly(showIconOnly)	Si truela valeur est , masque les valeurs et affiche uniquement les icônes.
setStyle(style)	Si cette option est définie, affiche l’option jeu d’icônes pour le format conditionnel.

Détails de la méthode

getCriteria()

Tableau de critères et jeux d’icônes pour les règles et icônes personnalisées potentielles pour les icônes conditionnelles. Notez que pour le premier critère, seule l’icône personnalisée peut être modifiée, tandis que le type, la formule et l’opérateur sont ignorés lorsqu’ils sont définis.

getCriteria(): ConditionalIconCriterion[];

Retours

ExcelScript.ConditionalIconCriterion[]

getReverseIconOrder()

Si truela valeur est , inverse les ordres d’icônes pour le jeu d’icônes. Notez que cela ne peut pas être défini si des icônes personnalisées sont utilisées.

getReverseIconOrder(): boolean;

Retours

boolean

getShowIconOnly()

Si truela valeur est , masque les valeurs et affiche uniquement les icônes.

getShowIconOnly(): boolean;

Retours

boolean

getStyle()

Si cette option est définie, affiche l’option jeu d’icônes pour le format conditionnel.

getStyle(): IconSet;

Retours

ExcelScript.IconSet

setCriteria(criteria)

Tableau de critères et jeux d’icônes pour les règles et icônes personnalisées potentielles pour les icônes conditionnelles. Notez que pour le premier critère, seule l’icône personnalisée peut être modifiée, tandis que le type, la formule et l’opérateur sont ignorés lorsqu’ils sont définis.

setCriteria(criteria: ConditionalIconCriterion[]): void;

Paramètres

criteria

ExcelScript.ConditionalIconCriterion[]

Retours

void

setReverseIconOrder(reverseIconOrder)

Si truela valeur est , inverse les ordres d’icônes pour le jeu d’icônes. Notez que cela ne peut pas être défini si des icônes personnalisées sont utilisées.

setReverseIconOrder(reverseIconOrder: boolean): void;

Paramètres

reverseIconOrder

boolean

Retours

void

setShowIconOnly(showIconOnly)

Si truela valeur est , masque les valeurs et affiche uniquement les icônes.

setShowIconOnly(showIconOnly: boolean): void;

Paramètres

showIconOnly

boolean

Retours

void

setStyle(style)

Si cette option est définie, affiche l’option jeu d’icônes pour le format conditionnel.

setStyle(style: IconSet): void;

Paramètres

style

ExcelScript.IconSet

Retours

void