Class ConditionalFormatRule

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 les règles d'une feuille donnée.

Méthodes

MéthodeType renvoyéBrève description
copy()ConditionalFormatRuleBuilderAffiche un préréglage de l'outil de création de règle avec les paramètres de cette règle.
getBooleanCondition()BooleanConditionRécupère les informations BooleanCondition de la règle si celle-ci utilise des critères de condition booléens.
getGradientCondition()GradientConditionRé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.

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 celle-ci utilise des critères de condition booléens. 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 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.
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 gradient, ou null si la règle n'utilise pas de condition de gradient.


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.