Cette page a été traduite par l'API Cloud Translation.

Class ConditionalFormatRuleBuilder

Outil de création de règles de mise en forme conditionnelle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Méthodes

Méthode	Type renvoyé	Brève description
`build()`	`ConditionalFormatRule`	Construit une règle de mise en forme conditionnelle à partir des paramètres appliqués au générateur.
`copy()`	`ConditionalFormatRuleBuilder`	Renvoie un préréglage de l'outil de création de règles avec les paramètres de cette règle.
`getBooleanCondition()`	`BooleanCondition`	Récupère les informations `BooleanCondition` de la règle si celle-ci utilise des critères de condition booléenne.
`getGradientCondition()`	`GradientCondition`	Récupère les informations `GradientCondition` de la règle, si cette règle utilise des critères de condition de gradient.
`getRanges()`	`Range[]`	Récupère les plages auxquelles cette règle de mise en forme conditionnelle est appliquée.
`setBackground(color)`	`ConditionalFormatRuleBuilder`	Définit la couleur d'arrière-plan pour le format de la règle de mise en forme conditionnelle.
`setBackgroundObject(color)`	`ConditionalFormatRuleBuilder`	Définit la couleur d'arrière-plan pour le format de la règle de mise en forme conditionnelle.
`setBold(bold)`	`ConditionalFormatRuleBuilder`	Définit le formatage en gras du texte pour le format de la règle de mise en forme conditionnelle.
`setFontColor(color)`	`ConditionalFormatRuleBuilder`	Définit la couleur de police pour le format de la règle de mise en forme conditionnelle.
`setFontColorObject(color)`	`ConditionalFormatRuleBuilder`	Définit la couleur de police pour le format de la règle de mise en forme conditionnelle.
`setGradientMaxpoint(color)`	`ConditionalFormatRuleBuilder`	Efface la valeur du point maximal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur maximale des plages de la règle.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	Efface la valeur du point maximal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur maximale des plages de la règle.
`setGradientMaxpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Définit les champs "maxpoint" du dégradé de la règle de mise en forme conditionnelle.
`setGradientMaxpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Définit les champs "maxpoint" du dégradé de la règle de mise en forme conditionnelle.
`setGradientMidpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Définit les champs de milieu de dégradé de la règle de mise en forme conditionnelle.
`setGradientMidpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Définit les champs de milieu de dégradé de la règle de mise en forme conditionnelle.
`setGradientMinpoint(color)`	`ConditionalFormatRuleBuilder`	Efface la valeur du point de départ du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur minimale des plages de la règle.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	Efface la valeur du point de départ du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur minimale des plages de la règle.
`setGradientMinpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Définit les champs de point de début du dégradé de la règle de mise en forme conditionnelle.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Définit les champs de point de début du dégradé de la règle de mise en forme conditionnelle.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	Définit le texte en italique pour le format de la règle de mise en forme conditionnelle.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	Définit une ou plusieurs plages auxquelles cette règle de mise en forme conditionnelle s'applique.
`setStrikethrough(strikethrough)`	`ConditionalFormatRuleBuilder`	Définit le texte barré pour le format de la règle de mise en forme conditionnelle.
`setUnderline(underline)`	`ConditionalFormatRuleBuilder`	Définit le soulignement du texte pour le format de la règle de mise en forme conditionnelle.
`whenCellEmpty()`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la cellule est vide.
`whenCellNotEmpty()`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la cellule n'est pas vide.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est postérieure à la valeur donnée.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est postérieure à la date relative donnée.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est antérieure à la date donnée.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est antérieure à la date relative donnée.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est égale à la date donnée.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est égale à la date relative donnée.
`whenFormulaSatisfied(formula)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la formule donnée renvoie `true`.
`whenNumberBetween(start, end)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre se situe entre deux valeurs spécifiées ou qu'il correspond à l'une d'elles.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est égal à la valeur donnée.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est supérieur à la valeur donnée.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Définit la règle de format conditionnel pour qu'elle se déclenche lorsqu'un nombre est supérieur ou égal à la valeur donnée.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est inférieur à la valeur donnée.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est inférieur ou égal à la valeur donnée.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre ne se situe pas entre deux valeurs spécifiées et qu'il ne correspond à aucune d'entre elles.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre n'est pas égal à la valeur donnée.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée contient la valeur donnée.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée ne contient pas la valeur donnée.
`whenTextEndsWith(text)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée se termine par la valeur donnée.
`whenTextEqualTo(text)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée est égale à la valeur donnée.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée commence par la valeur donnée.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	Définit la règle de format conditionnel sur des critères définis par des valeurs `BooleanCriteria`, généralement extraites des `criteria` et `arguments` d'une règle existante.

Documentation détaillée

`build()`

Construit une règle de mise en forme conditionnelle à partir des paramètres appliqués au générateur.

Renvois

ConditionalFormatRule : représentation de la règle de mise en forme conditionnelle

`copy()`

Renvoie un préréglage de l'outil de création de règles avec les paramètres de cette règle.

Renvois

ConditionalFormatRuleBuilder : compilateur basé sur les paramètres de cette règle

`getBooleanCondition()`

Récupère les informations BooleanCondition de la règle si celle-ci utilise des critères de condition booléenne. Sinon, renvoie null.

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Renvois

BooleanCondition : objet de condition booléenne ou null si la règle n'utilise pas de condition booléenne.

`getGradientCondition()`

Récupère les informations GradientCondition de la règle, si cette règle utilise des critères de condition de gradient. Sinon, renvoie null.

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

Renvois

GradientCondition : objet de condition de dégradé, ou null si la règle n'utilise pas de condition de dégradé.

`getRanges()`

Récupère les plages auxquelles cette règle de mise en forme conditionnelle est appliquée.

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Renvois

Range[] : plages auxquelles cette règle de mise en forme conditionnelle s'applique.

`setBackground(color)`

Définit la couleur d'arrière-plan pour le format de la règle de mise en forme conditionnelle. Transmettre null supprime le paramètre de format de couleur d'arrière-plan de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color to red if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`String`	La couleur souhaitée ou `null` pour effacer.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setBackgroundObject(color)`

Définit la couleur d'arrière-plan pour le format de la règle de mise en forme conditionnelle. Transmettre null supprime le paramètre de format de couleur d'arrière-plan de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color to theme background color if the cell has text
// equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`Color`	Objet de couleur souhaité ou `null` à effacer.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage.

`setBold(bold)`

Définit le formatage en gras du texte pour le format de la règle de mise en forme conditionnelle. Si bold est true, la règle met en gras le texte si la condition est remplie. Si false, la règle supprime tout texte en gras existant si la condition est remplie. Si vous transmettez null, le paramètre de mise en forme en gras est supprimé de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn their text bold if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBold(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`bold`	`Boolean`	Indique si le texte doit être en gras si la condition de mise en forme est remplie. `null` supprime ce paramètre.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setFontColor(color)`

Définit la couleur de police pour le format de la règle de mise en forme conditionnelle. Transmettre null supprime le paramètre de format de couleur de police de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their font color to red if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`String`	La couleur souhaitée ou `null` pour effacer.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setFontColorObject(color)`

Définit la couleur de police pour le format de la règle de mise en forme conditionnelle. Transmettre null supprime le paramètre de format de couleur de police de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their font color to theme text color if the cell has text equal to
// "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`Color`	Objet de couleur souhaité ou `null` à effacer.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage.

`setGradientMaxpoint(color)`

Efface la valeur du point maximal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur maximale des plages de la règle. Définit également la couleur du point maximal du dégradé sur la couleur d'entrée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between white and red, based on their
// values in comparison to the ranges minimum and maximum values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`String`	Couleur du point maximal à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setGradientMaxpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`Color`	Objet de couleur de point maximal à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage.

`setGradientMaxpointObjectWithValue(color, type, value)`

Définit les champs "maxpoint" du dégradé de la règle de mise en forme conditionnelle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1, accent 2 to accent
// 3 colors, based on their values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`Color`	Couleur du point maximal à définir.
`type`	`InterpolationType`	Type d'interpolation maxpoint à définir.
`value`	`String`	Valeur maxpoint à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage.

`setGradientMaxpointWithValue(color, type, value)`

Définit les champs "maxpoint" du dégradé de la règle de mise en forme conditionnelle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red green to blue, based on their
// values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`String`	Couleur du point maximal à définir.
`type`	`InterpolationType`	Type d'interpolation maxpoint à définir.
`value`	`String`	Valeur maxpoint à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setGradientMidpointObjectWithValue(color, type, value)`

Définit les champs de milieu de dégradé de la règle de mise en forme conditionnelle. Efface tous les champs de milieu de période si le type d'interpolation transmis est null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1 to accent 2 to
// accent 3 colors, based on their values in comparison to the values 0, 50, and
// 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`Color`	Couleur du point médian à définir.
`type`	`InterpolationType`	Type d'interpolation au milieu à définir ou `null` pour effacer.
`value`	`String`	Valeur médiane à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage.

`setGradientMidpointWithValue(color, type, value)`

Définit les champs de milieu de dégradé de la règle de mise en forme conditionnelle. Efface tous les champs de milieu de période si le type d'interpolation transmis est null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red green to blue, based on their
// values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`String`	Couleur du point médian à définir.
`type`	`InterpolationType`	Type d'interpolation au milieu à définir ou `null` pour effacer.
`value`	`String`	Valeur médiane à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setGradientMinpoint(color)`

Efface la valeur du point de départ du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur minimale des plages de la règle. Définit également la couleur du point minimal du dégradé sur la couleur d'entrée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between white and red, based on their
// values in comparison to the ranges minimum and maximum values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`String`	Couleur du point minimal à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setGradientMinpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`Color`	Objet de couleur de point minimal à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage.

`setGradientMinpointObjectWithValue(color, type, value)`

Définit les champs de point de début du dégradé de la règle de mise en forme conditionnelle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1 to accent 2 to
// accent 3 colors, based on their values in comparison to the values 0, 50, and
// 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`Color`	Couleur du point minimal à définir.
`type`	`InterpolationType`	Type d'interpolation de minpoint à définir.
`value`	`String`	Valeur de minpoint à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage.

`setGradientMinpointWithValue(color, type, value)`

Définit les champs de point de début du dégradé de la règle de mise en forme conditionnelle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red to green to blue, based on
// their values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`color`	`String`	Couleur du point minimal à définir.
`type`	`InterpolationType`	Type d'interpolation de minpoint à définir.
`value`	`String`	Valeur de minpoint à définir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setItalic(italic)`

Définit le texte en italique pour le format de la règle de mise en forme conditionnelle. Si italic est true, la règle met en italique le texte si la condition est remplie. Si false, la règle supprime toute italique existante si la condition est remplie. Si vous transmettez null, le paramètre de format en italique est supprimé de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn their text italic if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setItalic(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`italic`	`Boolean`	Indique si le texte doit être en italique si la condition de mise en forme est remplie. `null` supprime ce paramètre.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setRanges(ranges)`

Définit une ou plusieurs plages auxquelles cette règle de mise en forme conditionnelle s'applique. Cette opération remplace toutes les plages existantes. Définir un tableau vide supprime toutes les plages existantes. Une règle doit comporter au moins une plage.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3
// and range D4:F6 to turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeOne = sheet.getRange('A1:B3');
const rangeTwo = sheet.getRange('D4:F6');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([rangeOne, rangeTwo])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`ranges`	`Range[]`	Plages auxquelles cette règle de mise en forme conditionnelle s'applique.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setStrikethrough(strikethrough)`

Définit le texte barré pour le format de la règle de mise en forme conditionnelle. Si strikethrough est true, la règle barre le texte si la condition est remplie. Si false, la règle supprime toute mise en forme en barré existante si la condition est remplie. Si vous transmettez null, le paramètre de mise en forme en barré est supprimé de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// strikethrough their text if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setStrikethrough(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`strikethrough`	`Boolean`	Indique si le texte doit être barré si la condition de mise en forme est remplie. `null` supprime ce paramètre.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`setUnderline(underline)`

Définit le soulignement du texte pour le format de la règle de mise en forme conditionnelle. Si underline est true, la règle souligne le texte si la condition est remplie. Si false, la règle supprime toutes les soulignements existants si la condition est remplie. Si vous transmettez null, le paramètre de format en souligné est supprimé de la règle.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// underline their text if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setUnderline(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`underline`	`Boolean`	Indique si le texte doit être souligné si la condition de format est remplie. `null` supprime ce paramètre.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenCellEmpty()`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la cellule est vide.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are empty.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenCellNotEmpty()`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la cellule n'est pas vide.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are not empty.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellNotEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenDateAfter(date)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est postérieure à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date after 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`date`	`Date`	Date la plus récente.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenDateAfter(date)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est postérieure à la date relative donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date after today.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`date`	`RelativeDate`	Date la plus récente en fonction du type de date sélectionné.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenDateBefore(date)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est antérieure à la date donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date before 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`date`	`Date`	Date la plus proche non acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenDateBefore(date)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est antérieure à la date relative donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date before today.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`date`	`RelativeDate`	Date la plus récente en fonction du type de date sélectionné.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenDateEqualTo(date)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est égale à la date donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the date 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`date`	`Date`	Seule date acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenDateEqualTo(date)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'une date est égale à la date relative donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain todays date.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`date`	`RelativeDate`	Date la plus récente en fonction du type de date sélectionné.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenFormulaSatisfied(formula)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la formule donnée renvoie true.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they satisfy the condition "=EQ(B4, C3)".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenFormulaSatisfied('=EQ(B4, C3)')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`formula`	`String`	Formule personnalisée qui renvoie `true` si l'entrée est valide.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberBetween(start, end)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre se situe entre deux valeurs spécifiées ou qu'il correspond à l'une d'elles.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number between 1 and 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`start`	`Number`	Valeur la plus basse acceptable.
`end`	`Number`	Valeur la plus élevée acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberEqualTo(number)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est égal à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the number 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`number`	`Number`	Seule valeur acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberGreaterThan(number)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est supérieur à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number greater than 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur la plus élevée non acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberGreaterThanOrEqualTo(number)`

Définit la règle de format conditionnel pour qu'elle se déclenche lorsqu'un nombre est supérieur ou égal à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number greater than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur la plus basse acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberLessThan(number)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est inférieur à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number less than 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur la plus faible non acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberLessThanOrEqualTo(number)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre est inférieur ou égal à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number less than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur la plus élevée acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberNotBetween(start, end)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre ne se situe pas entre deux valeurs spécifiées et qu'il ne correspond à aucune d'entre elles.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number not between 1 and 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`start`	`Number`	Valeur la plus faible non acceptable.
`end`	`Number`	Valeur la plus élevée non acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenNumberNotEqualTo(number)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsqu'un nombre n'est pas égal à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they don't contain the number 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`number`	`Number`	Seule valeur non acceptée.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenTextContains(text)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée contient la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextContains('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`text`	`String`	Valeur que l'entrée doit contenir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenTextDoesNotContain(text)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée ne contient pas la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they don't contain the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextDoesNotContain('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`text`	`String`	Valeur que l'entrée ne doit pas contenir.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenTextEndsWith(text)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée se termine par la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they end with the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEndsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`text`	`String`	Texte à comparer à la fin de la chaîne.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenTextEqualTo(text)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée est égale à la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they have text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`text`	`String`	Seule valeur acceptable.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`whenTextStartsWith(text)`

Définit la règle de mise en forme conditionnelle pour qu'elle se déclenche lorsque la valeur d'entrée commence par la valeur donnée.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they start with the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextStartsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`text`	`String`	Texte à comparer au début de la chaîne.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage

`withCriteria(criteria, args)`

Définit la règle de format conditionnel sur des critères définis par des valeurs BooleanCriteria, généralement extraites des criteria et arguments d'une règle existante.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
const booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  const rule = SpreadsheetApp.newConditionalFormatRule()
                   .withCriteria(
                       booleanCondition.getCriteriaType(),
                       booleanCondition.getCriteriaValues(),
                       )
                   .setBackground('#000000')
                   .setRanges(rules[0].getRanges())
                   .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

Paramètres

Nom	Type	Description
`criteria`	`BooleanCriteria`	Type de critères de mise en forme conditionnelle.
`args`	`Object[]`	Tableau d'arguments approprié au type de critères. Le nombre d'arguments et leur type correspondent à la méthode `when...()` correspondante ci-dessus.

Renvois

ConditionalFormatRuleBuilder : compilateur, pour le chaînage