ExcelScript.IconSetConditionalFormat interface

Colis:

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é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.
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[];

Retourne

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;

Retourne

boolean

getShowIconOnly()

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

getShowIconOnly(): boolean;

Retourne

boolean

getStyle()

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

getStyle(): IconSet;

Retourne

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[]

Retourne

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

Retourne

void

setShowIconOnly(showIconOnly)

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

setShowIconOnly(showIconOnly: boolean): void;

Paramètres

showIconOnly

boolean

Retourne

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

Retourne

void