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é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 celle-ci utilise des critères de condition booléens. |
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. |
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.