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

Class BooleanCondition

Accédez aux conditions booléennes dans ConditionalFormatRules. Chaque règle de mise en forme conditionnelle ne peut contenir qu'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 génère 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
`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 condition 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 correspondant aux critères de la règle.
`getFontColorObject()`	`Color`	Récupère la couleur de police de 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 cette condition du texte.
`getStrikethrough()`	`Boolean`	Renvoie la valeur `true` si cette condition booléenne traverse le texte et renvoie `false` si cette condition booléenne supprime la barre 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.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
`getBackground()`	`String`	Récupère la chaîne de couleur d'arrière-plan pour cette condition booléenne.
`getFontColor()`	`String`	Récupère la chaîne de couleur de police pour cette condition booléenne.

Documentation détaillée

`getBackgroundObject()`

Récupère la couleur d'arrière-plan de cette condition booléenne. Renvoie la valeur null si ce champ n'est pas défini.

// 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 condition booléenne supprime la mise en gras du texte. Renvoie la valeur 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 bien null si cette option n'est pas affectée.

`getCriteriaType()`

Récupère le type de critère de la règle tel que défini dans l'énumération BooleanCriteria. Pour obtenir les arguments des critères, utilisez getCriteriaValues(). Pour créer ou modifier une règle de mise en forme conditionnelle à l'aide de ces valeurs, 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 correspondant aux critères de la règle. Pour obtenir le type de critère, utilisez getCriteriaType(). Pour créer ou modifier une règle de mise en forme conditionnelle à l'aide de ces valeurs, 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é 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 police de cette condition booléenne. Renvoie la valeur null si ce champ n'est pas défini.

// 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 elle n'est pas définie 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 cette condition du texte. Renvoie null si le texte en italique n'est pas affecté.

// 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 null si ce n'est pas le cas.

`getStrikethrough()`

Renvoie la valeur true si cette condition booléenne traverse le texte et renvoie false si cette condition booléenne supprime la barre du texte. Renvoie la valeur 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 est barrée ou non, ou null si le texte 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 la valeur null si le soulignement n'est pas affecté.

// 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é.

Méthodes obsolètes

`getBackground()`

Obsolète. Remplacé par getBackgroundObject()

Récupère la chaîne de couleur d'arrière-plan pour cette condition booléenne. Renvoie la valeur null si ce champ n'est pas défini.

// 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().getBackground();
  Logger.log("The background color for rule %s is %s", i, color);
}

Renvois

String : chaîne de couleur d'arrière-plan, ou null si elle n'est pas définie pour cette condition.

`getFontColor()`

Obsolète. Remplacé par getFontColorObject()

Récupère la chaîne de couleur de police pour cette condition booléenne. Renvoie la valeur null si ce champ n'est pas défini.

// 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().getFontColor();
  Logger.log("The font color for rule %s is %s", i, color);
}

Renvois

String : chaîne de couleur de la police, ou null si elle n'est pas définie pour cette condition.