Class ConditionalFormatRule

BedingteFormatRegel

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.

Bei Regeln, für die boolesche Bedingungskriterien verwendet werden, können Sie auf die Formatierungseinstellungen zugreifen, indem Sie getBooleanCondition() aufrufen und die Methoden für das zurückgegebene BooleanCondition-Objekt verwenden.

Methoden

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

Detaillierte Dokumentation

copy()

Gibt eine voreingestellte Regel-Builder-Konfiguration 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 für diese Regel boolesche Bedingungskriterien verwendet werden. Andernfalls wird null zurückgegeben. Boolesche Bedingungen enthalten Formatierungseinstellungen wie Schriftstärke, Schriftfarbe und Hintergrundfarbe.

// 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|null: Das boolesche Bedingungsobjekt oder null, wenn die Regel keine boolesche Bedingung verwendet.

---

getGradientCondition()

Ruft die GradientCondition-Informationen der Regel ab, wenn für diese Regel Gradientenbedingungen verwendet werden. 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|null: Das Gradientenbedingungsobjekt oder null, wenn für die Regel keine Gradientenbedingung verwendet wird.

---

getRanges()

Ruft die Bereiche ab, 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[]: Die Bereiche, auf die diese Regel für die bedingte Formatierung angewendet wird.