Class ConditionalFormatRule

Regola diformattazionecondizionale

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

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 utilizza criteri di condizione booleana.
getGradientCondition()	GradientCondition	Recupera le informazioni GradientCondition della regola, se questa utilizza i criteri della 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.

Invio

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.

// 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());
}

Invio

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

---

getGradientCondition()

Recupera le informazioni GradientCondition della regola, se questa utilizza i criteri della 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());
}

Invio

GradientCondition: l'oggetto condizione di sfumatura o null se la regola non utilizza una condizione di 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());
}

Invio

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