Accédez aux conditions booléennes dans ConditionalFormatRules
. Chaque
règle de mise en forme conditionnelle peut contenir une seule condition booléenne. La condition booléenne elle-même
contient un critère booléen (avec des valeurs) et des paramètres de mise en forme. Les critères sont évalués
par rapport au contenu d'une cellule, ce qui donne une valeur true
ou false
. Si le
prend la valeur true
, les paramètres de mise en forme de la condition sont appliqués à la cellule.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getBackgroundObject() | Color | Récupère la couleur d'arrière-plan de cette condition booléenne. |
getBold() | Boolean | Renvoie true si cette condition booléenne met le texte en gras et renvoie false si cette
booléenne supprime la mise en gras du texte. |
getCriteriaType() | BooleanCriteria | Récupère le type de critère de la règle tel que défini dans l'énumération BooleanCriteria . |
getCriteriaValues() | Object[] | Récupère un tableau d'arguments pour les critères de la règle. |
getFontColorObject() | Color | Récupère la couleur de la police pour cette condition booléenne. |
getItalic() | Boolean | Renvoie true si cette condition booléenne met le texte en italique et renvoie false si
cette condition booléenne supprime l'italique du texte. |
getStrikethrough() | Boolean | Renvoie true si cette condition booléenne dépasse le texte et renvoie false si cette condition booléenne supprime le barré du texte. |
getUnderline() | Boolean | Renvoie true si cette condition booléenne souligne le texte et renvoie false si
cette condition booléenne supprime le soulignement du texte. |
Documentation détaillée
getBackgroundObject()
Récupère la couleur d'arrière-plan de cette condition booléenne. Renvoie null
si la valeur n'est pas définie.
// Logs the boolean condition background color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getBackgroundObject(); Logger.log("The background color for rule %s is %s", i, color.asRgbColor().asHexString()); }
Renvois
Color
: couleur d'arrière-plan, ou null
si elle n'est pas définie pour cette condition.
getBold()
Renvoie true
si cette condition booléenne met le texte en gras et renvoie false
si cette
booléenne supprime la mise en gras du texte. Renvoie null
si la mise en gras n'est pas affectée.
// Logs the boolean condition font weight for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var bold = rules[i].getBooleanCondition().getBold(); Logger.log("The font bold setting for rule %s is %b", i, weight); }
Renvois
Boolean
: indique si la condition booléenne met le texte en gras ou non, ou null
si la mise en gras est
non affecté
getCriteriaType()
Récupère le type de critère de la règle tel que défini dans l'énumération BooleanCriteria
. Pour obtenir
arguments pour les critères, utilisez getCriteriaValues()
. Pour utiliser ces valeurs pour créer ou
modifier une règle de mise en forme conditionnelle, consultez ConditionalFormatRuleBuilder.withCriteria(criteria, args)
.
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
Renvois
BooleanCriteria
: type de critère de mise en forme conditionnelle
getCriteriaValues()
Récupère un tableau d'arguments pour les critères de la règle. Pour obtenir le type de critère, utilisez getCriteriaType()
. Pour utiliser ces valeurs afin de créer ou de modifier une règle de mise en forme conditionnelle, consultez
ConditionalFormatRuleBuilder.withCriteria(criteria, args)
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
Renvois
Object[]
: tableau d'arguments adaptés au type de critère de la règle. le nombre d'arguments
et leur type correspondent à la méthode when...()
correspondante de la classe ConditionalFormatRuleBuilder
.
getFontColorObject()
Récupère la couleur de la police pour cette condition booléenne. Renvoie null
si la valeur n'est pas définie.
// Logs the boolean condition font color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getFontColorObject(); Logger.log("The font color for rule %s is %s", i, color.asRgbColor().asHexString()); }
Renvois
Color
: couleur de la police, ou null
si aucun élément n'est défini pour cette condition.
getItalic()
Renvoie true
si cette condition booléenne met le texte en italique et renvoie false
si
cette condition booléenne supprime l'italique du texte. Renvoie null
si les caractères en italique sont
non concernées.
// Logs the boolean condition font style for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var italic = rules[i].getBooleanCondition().getItalic(); Logger.log("The font italic setting for rule %s is %b", i, italic); }
Renvois
Boolean
: indique si la condition booléenne met le texte en italique ou non, ou null
si
l'italique n'est pas affecté
getStrikethrough()
Renvoie true
si cette condition booléenne dépasse le texte et renvoie false
si cette condition booléenne supprime le barré du texte. Renvoie null
si
le barré n'est pas affecté.
// Logs the boolean condition strikethrough setting for each conditional format rule on a // sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var strikethrough = rules[i].getBooleanCondition().getStrikethrough(); Logger.log("The font strikethrough setting for rule %s is %b", i, strikethrough); }
Renvois
Boolean
: indique si la condition booléenne dépasse le texte, ou null
si
le barré n'est pas affecté
getUnderline()
Renvoie true
si cette condition booléenne souligne le texte et renvoie false
si
cette condition booléenne supprime le soulignement du texte. Renvoie null
si le texte est souligné
n'est pas affectée.
// Logs the boolean condition underline setting for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var underline = rules[i].getBooleanCondition().getUnderline(); Logger.log("The font underline setting for rule %s is %b", i, underline); }
Renvois
Boolean
: indique si la condition booléenne souligne le texte ou non, ou null
si
le soulignement n'est pas affecté