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 la configuración de formato. Los criterios se evalúan según el contenido de una celda, lo que da como resultado 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 booleana quita la negrita del texto.
getCriteriaType()	BooleanCriteria	Obtiene el tipo de criterio 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 aplica cursiva al texto y muestra false si esta condición booleana quita la cursiva del texto.
getStrikethrough()	Boolean	Muestra true si esta condición booleana afecta 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 se establece.

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

Devolvedor

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 booleana quita la negrita del texto. Muestra null si la negrita no se ve afectada.

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

Devolvedor

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

---

getCriteriaType()

Obtiene el tipo de criterio de la regla como se define en la enumeración BooleanCriteria. Para obtener los argumentos de los criterios, usa getCriteriaValues(). Si quieres usar estos valores para 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.
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);
  }
});

Devolvedor

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 criterio, usa getCriteriaType(). Si quieres usar estos valores para 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.
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);
  }
});

Devolvedor

Object[]: Es un array de argumentos apropiado para el tipo de criterio 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 se establece.

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

Devolvedor

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

---

getItalic()

Muestra true si esta condición booleana aplica cursiva al texto y muestra false si esta condición booleana quita la cursiva del texto. Muestra null si la cursiva no se ve afectada.

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

Devolvedor

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

---

getStrikethrough()

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

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

Devolvedor

Boolean: Indica si la condición booleana marca o no el texto, o null si el tachado 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 no se ve afectado el subrayado.

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

Devolvedor

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

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 se establece.

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

Devolvedor

String: Es la string 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 se establece.

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

Devolvedor

String: Es la string del color de la fuente o null si no se establece para esta condición.