Esta página foi traduzida pela API Cloud Translation.

Class BooleanCondition

Acesse condições booleanas em ConditionalFormatRules. Cada regra de formato condicional pode conter uma única condição booleana. A condição booleana contém um critério booleano (com valores) e configurações de formatação. Os critérios são avaliados em relação ao conteúdo de uma célula, resultando em um valor true ou false. Se os critérios forem avaliados como true, as configurações de formatação da condição serão aplicadas à célula.

Métodos

Método	Tipo de retorno	Breve descrição
`getBackgroundObject()`	`Color`	Recebe a cor do plano de fundo dessa condição booleana.
`getBold()`	`Boolean`	Retornará `true` se essa condição booleana remover o negrito do texto e retornará `false` se a condição booleana remover o negrito do texto.
`getCriteriaType()`	`BooleanCriteria`	Recebe o tipo de critérios da regra conforme definido no tipo enumerado `BooleanCriteria`.
`getCriteriaValues()`	`Object[]`	Recebe uma matriz de argumentos para os critérios da regra.
`getFontColorObject()`	`Color`	Recebe a cor da fonte dessa condição booleana.
`getItalic()`	`Boolean`	Retornará `true` se essa condição booleana remover o itálico do texto e retornará `false` se a condição booleana remover o itálico do texto.
`getStrikethrough()`	`Boolean`	Retornará `true` se essa condição booleana remover o tachado do texto e retornará `false` se a condição booleana remover o tachado do texto.
`getUnderline()`	`Boolean`	Retornará `true` se essa condição booleana sublinha o texto e retorna `false` se a condição booleana remover o sublinhado do texto.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`getBackground()`	`String`	Recebe a string de cores do plano de fundo para essa condição booleana.
`getFontColor()`	`String`	Recebe a string de cores da fonte para essa condição booleana.

Documentação detalhada

`getBackgroundObject()`

Recebe a cor do plano de fundo dessa condição booleana. Retorna null se não definido.

// 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());
}

Retornar

Color: a cor do plano de fundo, ou null se não for definida para esta condição.

`getBold()`

Retornará true se essa condição booleana remover o negrito do texto e retornará false se a condição booleana remover o negrito do texto. Retornará null se o efeito negrito não for afetado.

// 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);
}

Retornar

Boolean: se a condição booleana coloca o texto em negrito ou não, ou null se o negrito não for afetado.

`getCriteriaType()`

Recebe o tipo de critérios da regra conforme definido no tipo enumerado BooleanCriteria. Para acessar os argumentos para os critérios, use getCriteriaValues(). Para usar esses valores e criar ou modificar uma regra de formatação condicional, consulte 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);
  }
});

Retornar

BooleanCriteria: o tipo de critérios de formatação condicional

`getCriteriaValues()`

Recebe uma matriz de argumentos para os critérios da regra. Para ver o tipo de critério, use getCriteriaType(). Para usar esses valores e criar ou modificar uma regra de formatação condicional, consulte 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);
  }
});

Retornar

Object[]: uma matriz de argumentos apropriados para o tipo de critérios da regra. O número de argumentos e o tipo deles correspondem ao método when...() correspondente da classe ConditionalFormatRuleBuilder

`getFontColorObject()`

Recebe a cor da fonte dessa condição booleana. Retorna null se não definido.

// 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());
}

Retornar

Color: a cor da fonte, ou null se não definida para esta condição.

`getItalic()`

Retornará true se essa condição booleana remover o itálico do texto e retornará false se a condição booleana remover o itálico do texto. Retornará null se o itálico não for afetado.

// 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);
}

Retornar

Boolean: se a condição booleana coloca o texto em itálico ou null se a itálico não é afetada.

`getStrikethrough()`

Retornará true se essa condição booleana remover o tachado do texto e retornará false se a condição booleana remover o tachado do texto. Retornará null se o tachado não for afetado.

// 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);
}

Retornar

Boolean: se a condição booleana recebe ou não tachado no texto ou null se o tachado não for afetado.

`getUnderline()`

Retornará true se essa condição booleana sublinha o texto e retorna false se a condição booleana remover o sublinhado do texto. Retorna null se o sublinhado não for afetado.

// 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);
}

Retornar

Boolean: indica se a condição booleana sublinha o texto ou null se o sublinhado não é afetado.

Métodos obsoletos

`getBackground()`

Obsoleto. Substituído por getBackgroundObject()

Recebe a string de cores do plano de fundo para essa condição booleana. Retorna null se não definido.

// 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);
}

Retornar

String: a string de cores do plano de fundo, ou null se não for definida para essa condição.

`getFontColor()`

Obsoleto. Substituído por getFontColorObject()

Recebe a string de cores da fonte para essa condição booleana. Retorna null se não definido.

// 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);
}

Retornar

String: a string de cores da fonte, ou null se não foi definida para esta condição.