Class BooleanCondition

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étodoTipo de datos que se muestraDescripción breve
getBackgroundObject()ColorObtiene el color de fondo para esta condición booleana.
getBold()BooleanMuestra true si esta condición booleana aplica negrita al texto y muestra false si esta condición quita la negrita del texto.
getCriteriaType()BooleanCriteriaObtiene 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()ColorObtiene el color de fuente para esta condición booleana.
getItalic()BooleanMuestra 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()BooleanMuestra true si esta condición booleana tachado el texto y muestra false si esta condición booleana quita el tachado del texto.
getUnderline()BooleanMuestra true si esta condición booleana subraya el texto y muestra false si esta condición booleana quita el subrayado del texto.

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