Class ConditionalFormatRule

Regoladiformattazionecondizionale

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

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

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|null: l'oggetto condizione booleana o null se la regola non utilizza una condizione booleana.

getGradientCondition()

Recupera le informazioni GradientCondition della regola, se questa 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.
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|null: 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.