Se usó la API de Cloud Translation para traducir esta página.

Class BooleanCondition

Accede a las condiciones booleanas en ConditionalFormatRules. Cada regla de formato condicional puede contener una sola condición booleana. La condición booleana en sí contiene un criterio booleano (con valores) y una configuración de formato. Los criterios se evalúan en función del contenido de una celda, lo que genera un valor true o false. Si los criterios se evalúan como true, la configuración de formato de la condición se aplica a la celda.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getBackgroundObject()`	`Color`	Obtiene el color de fondo para esta condición booleana.
`getBold()`	`Boolean`	Muestra `true` si esta condición booleana aplica negrita al texto y muestra `false` si esta condición quita la negrita del texto.
`getCriteriaType()`	`BooleanCriteria`	Obtiene el tipo de criterios de la regla como se define en la enumeración `BooleanCriteria`.
`getCriteriaValues()`	`Object[]`	Obtiene un array de argumentos para los criterios de la regla.
`getFontColorObject()`	`Color`	Obtiene el color de fuente para esta condición booleana.
`getItalic()`	`Boolean`	Muestra `true` si esta condición booleana pone en cursiva el texto y muestra `false` si esta condición booleana quita la cursiva del texto.
`getStrikethrough()`	`Boolean`	Muestra `true` si esta condición booleana tachado el texto y muestra `false` si esta condición booleana quita el tachado del texto.
`getUnderline()`	`Boolean`	Muestra `true` si esta condición booleana subraya el texto y muestra `false` si esta condición booleana quita el subrayado del texto.

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
`getBackground()`	`String`	Obtiene la cadena de color de fondo para esta condición booleana.
`getFontColor()`	`String`	Obtiene la cadena de color de fuente para esta condición booleana.

Documentación detallada

`getBackgroundObject()`

Obtiene el color de fondo para esta condición booleana. Muestra null si no está configurado.

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

Volver

Color: Es el color de fondo o null si no se establece para esta condición.

`getBold()`

Muestra true si esta condición booleana aplica negrita al texto y muestra false si esta condición quita la negrita del texto. Muestra null si el texto en negrita no se ve afectado.

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

Volver

Boolean: Indica si la condición booleana aplica o no negrita al texto, o null si no se aplica.

`getCriteriaType()`

Obtiene el tipo de criterios de la regla como se define en la enumeración BooleanCriteria. Para obtener los argumentos de los criterios, usa getCriteriaValues(). Para usar estos valores y crear o modificar una regla de formato condicional, consulta ConditionalFormatRuleBuilder.withCriteria(criteria, args).

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

Volver

BooleanCriteria: Es el tipo de criterios de formato condicional.

`getCriteriaValues()`

Obtiene un array de argumentos para los criterios de la regla. Para obtener el tipo de criterios, usa getCriteriaType(). Para usar estos valores y crear o modificar una regla de formato condicional, consulta ConditionalFormatRuleBuilder.withCriteria(criteria, args).

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

Volver

Object[]: Es un array de argumentos adecuados para el tipo de criterios de la regla. La cantidad de argumentos y su tipo coinciden con el método when...() correspondiente de la clase ConditionalFormatRuleBuilder.

`getFontColorObject()`

Obtiene el color de fuente para esta condición booleana. Muestra null si no está configurado.

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

Volver

Color: Es el color de la fuente o null si no se configuró para esta condición.

`getItalic()`

Muestra true si esta condición booleana pone en cursiva el texto y muestra false si esta condición booleana quita la cursiva del texto. Muestra null si los itálicos no se ven afectados.

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

Volver

Boolean: Indica si la condición booleana pone en cursiva el texto o no, o null si no se ve afectado.

`getStrikethrough()`

Muestra true si esta condición booleana tachado el texto y muestra false si esta condición booleana quita el tachado del texto. Muestra null si la línea diagonal no se ve afectada.

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

Volver

Boolean: Indica si la condición booleana tachado el texto o no, o null si no se ve afectado.

`getUnderline()`

Muestra true si esta condición booleana subraya el texto y muestra false si esta condición booleana quita el subrayado del texto. Muestra null si el subrayado no se ve afectado.

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

Volver

Boolean: Indica si la condición booleana subraya el texto o no, o null si la subrayadura no se ve afectada.

Métodos obsoletos

`getBackground()`

Obsoleto. Se reemplazó por getBackgroundObject()

Obtiene la cadena de color de fondo para esta condición booleana. Muestra null si no está configurado.

// 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().getBackground();
  Logger.log(`Background color: ${color}`);
}

Volver

String: Es la cadena de color de fondo o null si no se establece para esta condición.

`getFontColor()`

Obsoleto. Se reemplazó por getFontColorObject()

Obtiene la cadena de color de fuente para esta condición booleana. Muestra null si no está configurado.

// 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) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

Volver

String: Es la cadena de color de fuente o null si no se configuró para esta condición.