Class ConditionalFormatRule

Regelfür bedingte Formatierung

Auf Regeln für die bedingte Formatierung zugreifen Verwenden Sie SpreadsheetApp.newConditionalFormatRule() und ConditionalFormatRuleBuilder, um eine neue Regel zu erstellen. Mit Sheet.setConditionalFormatRules(rules) können Sie die Regeln für ein bestimmtes Tabellenblatt festlegen.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
copy()	ConditionalFormatRuleBuilder	Gibt eine voreingestellte Regelvorlage mit den Einstellungen dieser Regel zurück.
getBooleanCondition()	BooleanCondition	Ruft die BooleanCondition-Informationen der Regel ab, wenn diese Regel boolesche Bedingungskriterien verwendet.
getGradientCondition()	GradientCondition	Ruft die GradientCondition-Informationen der Regel ab, wenn diese Regel Kriterien für stufenweise Bedingungen verwendet.
getRanges()	Range[]	Hier werden die Bereiche abgerufen, auf die diese Regel für die bedingte Formatierung angewendet wird.

Detaillierte Dokumentation

copy()

Gibt eine voreingestellte Regelvorlage mit den Einstellungen dieser Regel zurück.

Rückflug

ConditionalFormatRuleBuilder – ein Builder, der auf den Einstellungen dieser Regel basiert

---

getBooleanCondition()

Ruft die BooleanCondition-Informationen der Regel ab, wenn diese Regel boolesche Bedingungskriterien verwendet. Andernfalls wird null zurückgegeben.

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

Rückflug

BooleanCondition: das boolesche Bedingungsobjekt oder null, wenn in der Regel keine boolesche Bedingung verwendet wird.

---

getGradientCondition()

Ruft die GradientCondition-Informationen der Regel ab, wenn diese Regel Kriterien für stufenweise Bedingungen verwendet. Andernfalls wird null zurückgegeben.

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

Rückflug

GradientCondition: Das Objekt der Gradientenbedingung oder null, wenn in der Regel keine Gradientenbedingung verwendet wird.

---

getRanges()

Hier werden die Bereiche abgerufen, auf die diese Regel für die bedingte Formatierung angewendet wird.

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

Rückflug

Range[]: Bereiche, auf die diese Regel für die bedingte Formatierung angewendet wird.