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.