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 | Muestra un ajuste predeterminado del creador de reglas con la configuración de esta regla. |
getBooleanCondition() | BooleanCondition | Recupera la información BooleanCondition de la regla si esta usa criterios de condición booleano. |
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()
Muestra un ajuste predeterminado del creador de reglas con la configuración de esta regla.
Devolvedor
ConditionalFormatRuleBuilder
: Es un compilador basado en la configuración de esta regla.
getBooleanCondition()
Recupera la información BooleanCondition
de la regla si esta usa criterios de condición booleano. De lo contrario, muestra null
.
// Log the boolean criteria type of the first conditional format rules of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
Devolvedor
BooleanCondition
: Es el objeto de condición booleana, o bien 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. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
Devolvedor
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. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var ranges = rule.getRanges(); for (var i = 0; i < ranges.length; i++) { Logger.log(ranges[i].getA1Notation()); }
Devolvedor
Range[]
: Son los rangos a los que se aplica esta regla de formato condicional.