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

Class ConditionalFormatRule

Accéder aux règles de mise en forme conditionnelle Pour créer une règle, utilisez SpreadsheetApp.newConditionalFormatRule() et ConditionalFormatRuleBuilder. Vous pouvez utiliser Sheet.setConditionalFormatRules(rules) pour définir pour une feuille donnée.

Méthodes

Méthode	Type renvoyé	Brève description
`copy()`	`ConditionalFormatRuleBuilder`	Affiche un préréglage de l'outil de création de règle avec les paramètres de cette règle.
`getBooleanCondition()`	`BooleanCondition`	Récupère les informations `BooleanCondition` de la règle si cette règle utilise les critères de condition booléennes.
`getGradientCondition()`	`GradientCondition`	Récupère les informations `GradientCondition` de la règle, si celle-ci 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.

Documentation détaillée

`copy()`

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

Renvois

ConditionalFormatRuleBuilder : outil de création basé sur les paramètres de cette règle

`getBooleanCondition()`

Récupère les informations BooleanCondition de la règle si cette règle utilise les critères de condition booléennes. Sinon, renvoie null.

// Log the boolean criteria type of the first conditional format rules of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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 valeur booléenne .

`getGradientCondition()`

Récupère les informations GradientCondition de la règle, si celle-ci 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Renvois

Range[] : plages auxquelles cette règle de mise en forme conditionnelle est appliquée.