Esta página foi traduzida pela API Cloud Translation.

Class BooleanCondition

Acesse condições booleanas em ConditionalFormatRules. Cada regra de formatação condicional pode conter uma única condição booleana. A condição booleana em si 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 o critério for avaliado 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 de fundo dessa condição booleana.
`getBold()`	`Boolean`	Retornará `true` se essa condição booleana aplicar negrito ao texto e retornará `false` se essa condição booleana remover o negrito do texto.
`getCriteriaType()`	`BooleanCriteria`	Recebe o tipo de critério da regra, conforme definido na enumeração `BooleanCriteria`.
`getCriteriaValues()`	`Object[]`	Recebe uma matriz de argumentos para os critérios da regra.
`getFontColorObject()`	`Color`	Recebe a cor da fonte para esta condição booleana.
`getItalic()`	`Boolean`	Retornará `true` se essa condição booleana aplicar itálico ao texto e retornará `false` se essa condição booleana remover itálico do texto.
`getStrikethrough()`	`Boolean`	Retornará `true` se essa condição booleana ocorrer ao longo do texto e retornará `false` se ela remover o tachado do texto.
`getUnderline()`	`Boolean`	Retornará `true` se essa condição booleana sublinhar o texto e retornará `false` se essa condição booleana remover o sublinhado do texto.

Métodos obsoletos

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

Documentação detalhada

`getBackgroundObject()`

Recebe a cor de fundo dessa condição booleana. Retorna null se não for 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());
}

Retorno

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

`getBold()`

Retornará true se essa condição booleana aplicar negrito ao texto e retornará false se essa condição booleana remover o negrito do texto. Retornará null se o 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);
}

Retorno

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ério da regra, conforme definido na enumeração BooleanCriteria. Para acessar os argumentos para os critérios, use getCriteriaValues(). Para usar esses valores para 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);
  }
});

Retorno

BooleanCriteria: o tipo de critério 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 para 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);
  }
});

Retorno

Object[]: uma matriz de argumentos apropriados ao 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 para esta condição booleana. Retorna null se não for 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());
}

Retorno

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

`getItalic()`

Retornará true se essa condição booleana aplicar itálico ao texto e retornará false se essa condição booleana remover itálico do texto. Retorna 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);
}

Retorno

Boolean: se a condição booleana coloca o texto em itálico ou não, ou null se o itálico não for afetado

`getStrikethrough()`

Retornará true se essa condição booleana ocorrer ao longo do texto e retornará false se ela remover o tachado do texto. Retorna 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);
}

Retorno

Boolean: se a condição booleana atinge ou não o texto, ou null se o tachado não for afetado

`getUnderline()`

Retornará true se essa condição booleana sublinhar o texto e retornará false se essa condição booleana remover o sublinhado do texto. Retornará 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);
}

Retorno

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

Métodos obsoletos

`getBackground()`

Obsoleto. Substituído por getBackgroundObject()

Recebe a string da cor de fundo para esta condição booleana. Retorna null se não for 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);
}

Retorno

String: a string da cor de plano de fundo, ou null, se não estiver definida para essa condição.

`getFontColor()`

Obsoleto. Substituído por getFontColorObject()

Recebe a string de cor da fonte para esta condição booleana. Retorna null se não for 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);
}

Retorno

String: a string de cor da fonte, ou null, se não estiver definida para essa condição.