Class ConditionalFormatRule

ConditionalFormatRule

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.

Per le regole che utilizzano criteri di condizione booleana, puoi accedere alle impostazioni di formattazione chiamando getBooleanCondition() e utilizzando i metodi sull'oggetto BooleanCondition restituito.

Metodi

Metodo	Tipo restituito	Breve descrizione
copy()	ConditionalFormatRuleBuilder	Restituisce un preset del generatore di regole con le impostazioni di questa regola.
getBooleanCondition()	BooleanCondition|null	Recupera le informazioni BooleanCondition della regola se questa utilizza criteri di condizione booleana.
getGradientCondition()	GradientCondition|null	Recupera le informazioni GradientCondition della regola, se questa 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 generatore 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. Le condizioni booleane contengono impostazioni di formattazione come spessore del carattere, colore del carattere e colore di sfondo.

// 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 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|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.