Acessar regras de formatação condicional Para criar uma regra, use SpreadsheetApp.newConditionalFormatRule() e ConditionalFormatRuleBuilder.
É possível usar Sheet.setConditionalFormatRules(rules) para definir as regras de uma determinada página.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
copy() | ConditionalFormatRuleBuilder | Retorna uma predefinição de criador de regras com as configurações desta regra. |
getBooleanCondition() | BooleanCondition | Recupera as informações do BooleanCondition da regra se essa regra usar critérios de condição booleana. |
getGradientCondition() | GradientCondition | Recupera as informações do GradientCondition da regra se essa regra usar critérios de condição de gradiente. |
getRanges() | Range[] | Recupera os intervalos a que esta regra de formatação condicional é aplicada. |
Documentação detalhada
copy()
Retorna uma predefinição de criador de regras com as configurações desta regra.
Retornar
ConditionalFormatRuleBuilder: um builder baseado nas configurações desta regra
getBooleanCondition()
Recupera as informações do BooleanCondition da regra se essa regra usar critérios de condição booleana. Caso contrário, retorna 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());
}
Retornar
BooleanCondition: o objeto da condição booleana, ou null se a regra não usar uma condição booleana.
getGradientCondition()
Recupera as informações do GradientCondition da regra se essa regra usar critérios de condição de gradiente. Caso contrário, retorna 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());
}
Retornar
GradientCondition: o objeto da condição de gradiente ou null se a regra não usar uma condição de gradiente.
getRanges()
Recupera os intervalos a que esta regra de formatação condicional é aplicada.
// 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());
}
Retornar
Range[]: os intervalos aos quais a regra de formatação condicional é aplicada.