Class ConditionalFormatRule

ConditionalFormatRule

Accede a las reglas de formato condicional. Para crear una regla nueva, usa SpreadsheetApp.newConditionalFormatRule() y ConditionalFormatRuleBuilder. Puedes usar Sheet.setConditionalFormatRules(rules) para establecer las reglas de una hoja determinada.

Para las reglas que usan criterios de condición booleanos, puedes acceder a la configuración de formato llamando a getBooleanCondition() y usando los métodos en el objeto BooleanCondition que se muestra.

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
copy()	ConditionalFormatRuleBuilder	Muestra un parámetro preestablecido del compilador de reglas con la configuración de esta regla.
getBooleanCondition()	BooleanCondition|null	Recupera la información de BooleanCondition de la regla si esta usa criterios de condición booleanos.
getGradientCondition()	GradientCondition|null	Recupera la información de GradientCondition de la regla si esta usa criterios de condición de gradiente.
getRanges()	Range[]	Recupera los rangos a los que se aplica esta regla de formato condicional.

Documentación detallada

copy()

Muestra un parámetro preestablecido del compilador de reglas con la configuración de esta regla.

Volver

ConditionalFormatRuleBuilder: Un compilador basado en la configuración de esta regla.

---

getBooleanCondition()

Recupera la información de BooleanCondition de la regla si esta usa criterios de condición booleanos. De lo contrario, muestra null. Las condiciones booleanas contienen parámetros de configuración de formato, como el grosor de la fuente, el color de la fuente y el color de fondo.

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Volver

BooleanCondition|null — El objeto de condición booleana o null si la regla no usa una condición booleana.

---

getGradientCondition()

Recupera la información de GradientCondition de la regla si esta usa criterios de condición de gradiente. De lo contrario, muestra null.

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

Volver

GradientCondition|null: El objeto de condición de gradiente o null si la regla no usa una condición de gradiente.

---

getRanges()

Recupera los rangos a los que se aplica esta regla de formato condicional.

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Volver

Range[]: Los rangos a los que se aplica esta regla de formato condicional.