Class ConditionalFormatRule

Regola di formattazionecondizionale

Accedi 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

MetodoTipo restituitoBreve descrizione
copy()ConditionalFormatRuleBuilderRestituisce un preset del generatore di regole con le impostazioni di questa regola.
getBooleanCondition()BooleanConditionRecupera le informazioni BooleanCondition della regola se questa utilizza criteri di condizione booleana.
getGradientCondition()GradientConditionRecupera le informazioni GradientCondition della regola, se questa regola utilizza criteri di condizione di 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.

Indietro

ConditionalFormatRuleBuilder: un builder basato sulle impostazioni di questa regola.

getBooleanCondition()

Recupera le informazioni BooleanCondition della regola se questa utilizza criteri di condizione booleana. In caso contrario, restituisce 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());
}

Indietro

BooleanCondition: l'oggetto condizione booleana o null se la regola non utilizza una condizione booleana.

getGradientCondition()

Recupera le informazioni GradientCondition della regola, se questa regola utilizza criteri di condizione di gradiente. In caso contrario, restituisce 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());
}

Indietro

GradientCondition: l'oggetto condizione sfumatura o null se la regola non utilizza una condizione sfumatura.

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.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Indietro

Range[]: gli intervalli a cui viene applicata questa regola di formattazione condizionale.