Class ConditionalFormatRule

ConditionalFormatRule

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 für ein bestimmtes Tabellenblatt.

Methoden

MethodeRückgabetypKurzbeschreibung
copy()ConditionalFormatRuleBuilderGibt eine Voreinstellung zum Erstellen von Regeln mit den Einstellungen dieser Regel zurück.
getBooleanCondition()BooleanConditionRuft die BooleanCondition-Informationen der Regel ab, wenn für diese Regel Folgendes verwendet wird: booleschen Bedingungskriterien.
getGradientCondition()GradientConditionRuft die GradientCondition-Informationen der Regel ab, wenn diese Regel Kriterien für die Gradientenbedingung.
getRanges()Range[]Ruft die Bereiche ab, auf die diese Regel für die bedingte Formatierung angewendet wird.

Detaillierte Dokumentation

copy()

Gibt eine Voreinstellung zum Erstellen von Regeln 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 Folgendes verwendet wird: booleschen Bedingungskriterien. 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());
}

Rückflug

BooleanCondition: das boolesche Bedingungsobjekt oder null, wenn in der Regel kein boolescher Wert verwendet wird .

getGradientCondition()

Ruft die GradientCondition-Informationen der Regel ab, wenn diese Regel Kriterien für die Gradientenbedingung. 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());
}

Rückflug

GradientCondition: Das Bedingungsobjekt für den Farbverlauf oder null, wenn in der Regel kein Farbverlauf 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var 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.