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.