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

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