Class ConditionalFormatRule

ConditionalFormatRule

Acceder 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.

En el caso de 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 del objeto BooleanCondition que se muestra.

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
copy()	ConditionalFormatRuleBuilder	Devuelve un ajuste predeterminado 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 booleana.
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()

Devuelve un ajuste predeterminado del compilador de reglas con la configuración de esta regla.

Volver

ConditionalFormatRuleBuilder: Es 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 booleana. De lo contrario, devuelve null. Las condiciones booleanas contienen parámetros de configuración de formato, como el grosor, el color y el color de fondo de la fuente.

// 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: Es 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, devuelve 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: Es 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[]: Son los rangos a los que se aplica esta regla de formato condicional.