Regeln für die bedingte Formatierung aufrufen 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 Voreinstellung zur Regelerstellung 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 Gradientenbedingungskriterien verwendet. |
getRanges() | Range[] | Ruft die Bereiche ab, auf die diese Regel zur bedingten Formatierung angewendet wird. |
Detaillierte Dokumentation
copy()
Gibt eine Voreinstellung zur Regelerstellung mit den Einstellungen dieser Regel zurück.
Return
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. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
Return
BooleanCondition
: das boolesche Bedingungsobjekt oder null
, wenn die Regel keine boolesche Bedingung verwendet
getGradientCondition()
Ruft die GradientCondition
-Informationen der Regel ab, wenn diese Regel Gradientenbedingungskriterien verwendet. Andernfalls wird null
zurückgegeben.
// Log the gradient minimum color of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
Return
GradientCondition
: das Verlaufsbedingungsobjekt oder null
, wenn in der Regel keine Gradientenbedingung verwendet wird
getRanges()
Ruft die Bereiche ab, auf die diese Regel zur bedingten Formatierung angewendet wird.
// Log each range of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var ranges = rule.getRanges(); for (var i = 0; i < ranges.length; i++) { Logger.log(ranges[i].getA1Notation()); }
Return
Range[]
: Die Bereiche, auf die diese Regel zur bedingten Formatierung angewendet wird.