Accédez aux conditions booléennes dans Conditional
. Chaque règle de format conditionnel ne peut contenir qu'une seule condition booléenne. La condition booléenne elle-même contient des critères booléens (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 les critères renvoient 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 |
---|---|---|
get | Color | Récupère la couleur d'arrière-plan de cette condition booléenne. |
get | Boolean | Renvoie true si cette condition booléenne met en gras le texte et renvoie false si cette condition booléenne supprime le texte en gras. |
get | Boolean | Récupère le type de critères de la règle tel que défini dans l'énumération Boolean . |
get | Object[] | Récupère un tableau d'arguments pour les critères de la règle. |
get | Color | Récupère la couleur de la police pour cette condition booléenne. |
get | Boolean | Renvoie true si cette condition booléenne met le texte en italique et false si elle le supprime. |
get | Boolean | Renvoie true si cette condition booléenne barre le texte et false si elle le supprime. |
get | Boolean | Renvoie true si cette condition booléenne souligne le texte et false si elle supprime le soulignement du texte. |
Documentation détaillée
get Background Object()
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. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const color = rule.getBooleanCondition().getBackgroundObject(); Logger.log(`Background color: ${color.asRgbColor().asHexString()}`); }
Renvois
Color
: couleur d'arrière-plan, ou null
si elle n'est pas définie pour cette condition.
get Bold()
Renvoie true
si cette condition booléenne met en gras le texte et renvoie false
si cette condition booléenne supprime le texte en gras. Renvoie null
si l'italique n'est pas affecté.
// Logs the boolean condition font weight for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const bold = rule.getBooleanCondition().getBold(); Logger.log(`Bold: ${bold}`); }
Renvois
Boolean
: indique si la condition booléenne met en gras le texte ou non, ou null
si le texte n'est pas mis en gras
get Criteria Type()
Récupère le type de critères de la règle tel que défini dans l'énumération Boolean
. Pour obtenir les arguments des critères, utilisez get
. Pour utiliser ces valeurs afin de créer ou de modifier une règle de mise en forme conditionnelle, consultez Conditional
.
// Log information about the conditional formats on the active sheet that use // boolean conditions. const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats(); SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => { const booleanCondition = format.getBooleanCondition(); if (booleanCondition) { const criteria = booleanCondition.getCriteriaType(); const args = booleanCondition.getCriteriaValues(); Logger.log(`The conditional format rule is ${criteria} ${args}`); } });
Renvois
Boolean
: type de critères de mise en forme conditionnelle.
get Criteria Values()
Récupère un tableau d'arguments pour les critères de la règle. Pour obtenir le type de critères, utilisez get
. Pour utiliser ces valeurs pour créer ou modifier une règle de mise en forme conditionnelle, consultez Conditional
.
// Log information about the conditional formats on the active sheet that use // boolean conditions. const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats(); SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => { const booleanCondition = format.getBooleanCondition(); if (booleanCondition) { const criteria = booleanCondition.getCriteriaType(); const args = booleanCondition.getCriteriaValues(); Logger.log(`The conditional format rule is ${criteria} ${args}`); } });
Renvois
Object[]
: tableau d'arguments approprié au type de critères de la règle. Le nombre d'arguments et leur type correspondent à la méthode when...()
correspondante de la classe Conditional
.
get Font Color Object()
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. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const color = rule.getBooleanCondition().getFontColorObject(); Logger.log(`Font color: ${color.asRgbColor().asHexString()}`); }
Renvois
Color
: couleur de la police, ou null
si elle n'est pas définie pour cette condition.
get Italic()
Renvoie true
si cette condition booléenne met le texte en italique et false
si elle le supprime. Renvoie null
si les italiques ne sont pas affectés.
// Logs the boolean condition font style for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const italic = rule.getBooleanCondition().getItalic(); Logger.log(`Italic: ${italic}`); }
Renvois
Boolean
: indique si la condition booléenne met en italique le texte ou non, ou null
si l'italique n'est pas affectée.
get Strikethrough()
Renvoie true
si cette condition booléenne barre le texte et false
si elle le supprime. Renvoie null
si le trait barré n'est pas affecté.
// Logs the boolean condition strikethrough setting for each conditional format // rule on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const strikethrough = rule.getBooleanCondition().getStrikethrough(); Logger.log(`Strikethrough: ${strikethrough}`); }
Renvois
Boolean
: indique si la condition booléenne barre le texte ou non, ou null
si le texte n'est pas barré.
get Underline()
Renvoie true
si cette condition booléenne souligne le texte et false
si elle supprime le soulignement du texte. Renvoie null
si le soulignement n'est pas affecté.
// Logs the boolean condition underline setting for each conditional format rule // on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const underline = rule.getBooleanCondition().getUnderline(); Logger.log(`Underline: ${underline}`); }
Renvois
Boolean
: indique si la condition booléenne souligne le texte ou non, ou null
si le soulignement n'est pas affecté.