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.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
copy()	ConditionalFormatRuleBuilder	Devuelve un ajuste predeterminado del compilador de reglas con la configuración de esta regla.
getBooleanCondition()	BooleanCondition	Recupera la información de BooleanCondition de la regla si esta usa criterios de condición booleana.
getGradientCondition()	GradientCondition	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.

// 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: 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: 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.