Accedere alle regole di formattazione condizionale. Per creare una nuova regola, utilizza SpreadsheetApp.newConditionalFormatRule()
e ConditionalFormatRuleBuilder
.
Puoi utilizzare Sheet.setConditionalFormatRules(rules)
per impostare
le regole per un determinato foglio.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
copy() | ConditionalFormatRuleBuilder | Restituisce un preset del generatore di regole con le impostazioni di questa regola. |
getBooleanCondition() | BooleanCondition | Recupera le informazioni BooleanCondition della regola se questa regola utilizza
criteri di condizione booleani. |
getGradientCondition() | GradientCondition | Recupera le informazioni GradientCondition della regola, se la regola utilizza criteri di condizione del gradiente. |
getRanges() | Range[] | Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale. |
Documentazione dettagliata
copy()
Restituisce un preset del generatore di regole con le impostazioni di questa regola.
Ritorni
ConditionalFormatRuleBuilder
: un generatore basato sulle impostazioni di questa regola
getBooleanCondition()
Recupera le informazioni BooleanCondition
della regola se questa regola utilizza
criteri di condizione booleani. In caso contrario, restituisce 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()); }
Ritorni
BooleanCondition
: l'oggetto condizione booleano o null
se la regola non utilizza una condizione booleana.
getGradientCondition()
Recupera le informazioni GradientCondition
della regola, se la regola utilizza criteri di condizione del gradiente. In caso contrario, restituisce 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()); }
Ritorni
GradientCondition
: l'oggetto della condizione del gradiente o null
se la regola non utilizza una condizione del gradiente.
getRanges()
Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale.
// 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()); }
Ritorni
Range[]
: gli intervalli a cui viene applicata la regola di formattazione condizionale.