Class ConditionalFormatRule

Regel für die bedingteFormatierung

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

MethodeRückgabetypKurzbeschreibung
copy()ConditionalFormatRuleBuilderGibt eine voreingestellte Regel-Builder-Konfiguration mit den Einstellungen dieser Regel zurück.
getBooleanCondition()BooleanConditionRuft die BooleanCondition-Informationen der Regel ab, wenn für diese Regel boolesche Bedingungskriterien verwendet werden.
getGradientCondition()GradientConditionRuft 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. 

// 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 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: 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.