Diese Seite wurde von der Cloud Translation API übersetzt.

Class ConditionalFormatRuleBuilder

Generator für Regeln für die bedingte Formatierung

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`ConditionalFormatRule`	Erstellt eine Regel für die bedingte Formatierung aus den Einstellungen, die auf den Builder angewendet wurden.
`copy()`	`ConditionalFormatRuleBuilder`	Gibt eine Voreinstellung zum Erstellen von Regeln mit den Einstellungen dieser Regel zurück.
`getBooleanCondition()`	`BooleanCondition`	Ruft die `BooleanCondition`-Informationen der Regel ab, wenn für diese Regel Folgendes verwendet wird: booleschen Bedingungskriterien.
`getGradientCondition()`	`GradientCondition`	Ruft 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.
`setBackground(color)`	`ConditionalFormatRuleBuilder`	Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest.
`setBackgroundObject(color)`	`ConditionalFormatRuleBuilder`	Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest.
`setBold(bold)`	`ConditionalFormatRuleBuilder`	Legt fest, dass Text im Format der Regel für die bedingte Formatierung fett formatiert wird.
`setFontColor(color)`	`ConditionalFormatRuleBuilder`	Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest.
`setFontColorObject(color)`	`ConditionalFormatRuleBuilder`	Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest.
`setGradientMaxpoint(color)`	`ConditionalFormatRuleBuilder`	Löscht den Maximalpunktwert des Farbverlaufs der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel ein.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	Löscht den Maximalpunktwert des Farbverlaufs der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel ein.
`setGradientMaxpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Höchstpunktfelder für den Gradienten in der Regel für die bedingte Formatierung fest.
`setGradientMaxpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Höchstpunktfelder für den Gradienten in der Regel für die bedingte Formatierung fest.
`setGradientMidpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Farbverlaufsmittelpunktfelder der Regel für die bedingte Formatierung fest
`setGradientMidpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Farbverlaufsmittelpunktfelder der Regel für die bedingte Formatierung fest
`setGradientMinpoint(color)`	`ConditionalFormatRuleBuilder`	Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel ein.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel ein.
`setGradientMinpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Mindestpunkte für den Gradienten in der Regel für die bedingte Formatierung fest.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Mindestpunkte für den Gradienten in der Regel für die bedingte Formatierung fest.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	Legt kursiven Text für das Format der Regel für die bedingte Formatierung fest.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	Legt einen oder mehrere Bereiche fest, auf die diese Regel für die bedingte Formatierung angewendet wird.
`setStrikethrough(strikethrough)`	`ConditionalFormatRuleBuilder`	Legt fest, dass Text für das Format der Regel für die bedingte Formatierung durchgestrichen wird.
`setUnderline(underline)`	`ConditionalFormatRuleBuilder`	Legt Text für das Format der Regel für die bedingte Formatierung fest.
`whenCellEmpty()`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Zelle leer ist.
`whenCellNotEmpty()`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Zelle nicht leer ist.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum nach dem angegebenen Wert liegt.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum nach dem angegebenen relativen Datum liegt.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum vor dem angegebenen Datum liegt.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum vor dem angegebenen relativen Datum liegt.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum mit dem angegebenen Datum übereinstimmt.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum mit dem angegebenen relativen Datum übereinstimmt.
`whenFormulaSatisfied(formula)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die angegebene Formel `true` ergibt.
`whenNumberBetween(start, end)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl zwischen zwei oder einer von zwei liegt angegebenen Werten.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl gleich dem angegebenen Wert ist.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl größer als der angegebene Wert ist.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer oder gleich der angegebenen ist Wert.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl kleiner als die angegebene ist Wert.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner oder gleich der angegebenen Wert.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl nicht zwischen diesen liegt und keines von beiden ist zwei angegebenen Werte.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl ungleich dem angegebenen Wert ist.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe den angegebenen Wert enthält.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe das angegebene Wert.
`whenTextEndsWith(text)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert endet.
`whenTextEqualTo(text)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe dem angegebenen Wert entspricht.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert beginnt.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	Legt die Regel für die bedingte Formatierung auf Kriterien fest, die durch `BooleanCriteria`-Werte definiert sind, normalerweise aus den `criteria` und `arguments` einer bestehenden Regel.

Detaillierte Dokumentation

`build()`

Erstellt eine Regel für die bedingte Formatierung aus den Einstellungen, die auf den Builder angewendet wurden.

Rückflug

ConditionalFormatRule – eine Darstellung der Regel für die bedingte Formatierung

`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.

`setBackground(color)`

Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Bestanden in null wird die Einstellung für das Hintergrundfarbenformat aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die gewünschte Farbe oder `null`, die gelöscht werden sollen.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setBackgroundObject(color)`

Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Bestanden in null wird die Einstellung für das Hintergrundfarbenformat aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to theme background color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das gewünschte Farbobjekt oder `null`, das gelöscht werden soll.

Rückflug

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

`setBold(bold)`

Legt fest, dass Text im Format der Regel für die bedingte Formatierung fett formatiert wird. Wenn bold den Wert true hat, Wenn die Bedingung erfüllt ist, wird der Text durch die Regel fett formatiert. Bei false werden durch die Regel alle wird fett formatiert, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Einstellung für das Fettformat aus folgenden Elementen entfernt: die Regel.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text bold if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`bold`	`Boolean`	Gibt an, ob der Text fett formatiert werden soll, wenn die Formatbedingung erfüllt ist; `null` entfernt diese Einstellung.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setFontColor(color)`

Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Bei der Übergabe von null wird Folgendes entfernt: die Einstellung für das Schriftfarbformat.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die gewünschte Farbe oder `null`, die gelöscht werden sollen.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setFontColorObject(color)`

Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Bei der Übergabe von null wird Folgendes entfernt: die Einstellung für das Schriftfarbformat.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to theme text color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das gewünschte Farbobjekt oder `null`, das gelöscht werden soll.

Rückflug

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

`setGradientMaxpoint(color)`

Löscht den Maximalpunktwert des Farbverlaufs der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel ein. Außerdem wird die Maximalpunktfarbe des Farbverlaufs auf die Eingabefarbe festgelegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die festzulegende Maximalpunktfarbe.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setGradientMaxpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das festzulegende maxpoint-Farbobjekt

Rückflug

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

`setGradientMaxpointObjectWithValue(color, type, value)`

Legt die Höchstpunktfelder für den Gradienten in der Regel für die bedingte Formatierung fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their
// values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die festzulegende Maximalpunktfarbe.
`type`	`InterpolationType`	Der festzulegende Höchstpunktinterpolationstyp.
`value`	`String`	Der festzulegende Maximalpunktwert.

Rückflug

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

`setGradientMaxpointWithValue(color, type, value)`

Legt die Höchstpunktfelder für den Gradienten in der Regel für die bedingte Formatierung fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die festzulegende Maximalpunktfarbe.
`type`	`InterpolationType`	Der festzulegende Höchstpunktinterpolationstyp.
`value`	`String`	Der festzulegende Maximalpunktwert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setGradientMidpointObjectWithValue(color, type, value)`

Legt die Farbverlaufsmittelpunktfelder der Regel für die bedingte Formatierung fest Löscht alle Mittelpunktfelder Der übergebene Interpolationstyp ist null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die festzulegende Farbe für den Mittelpunkt.
`type`	`InterpolationType`	Der Typ der Mittelpunktinterpolation, der festgelegt werden soll, oder `null`, der gelöscht werden soll.
`value`	`String`	Der festzulegende Mittelwert.

Rückflug

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

`setGradientMidpointWithValue(color, type, value)`

Legt die Farbverlaufsmittelpunktfelder der Regel für die bedingte Formatierung fest Löscht alle Mittelpunktfelder Der übergebene Interpolationstyp ist null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die festzulegende Farbe für den Mittelpunkt.
`type`	`InterpolationType`	Der Typ der Mittelpunktinterpolation, der festgelegt werden soll, oder `null`, der gelöscht werden soll.
`value`	`String`	Der festzulegende Mittelwert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setGradientMinpoint(color)`

Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel ein. Außerdem wird die Minimalpunktfarbe des Farbverlaufs auf die Eingabefarbe festgelegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die festzulegende Minimalpunktfarbe.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setGradientMinpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das festzulegende Minpoint-Farbobjekt

Rückflug

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

`setGradientMinpointObjectWithValue(color, type, value)`

Legt die Mindestpunkte für den Gradienten in der Regel für die bedingte Formatierung fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die festzulegende Minimalpunktfarbe.
`type`	`InterpolationType`	Der festzulegende Minpoint-Interpolationstyp.
`value`	`String`	Der festzulegende Minimalwert.

Rückflug

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

`setGradientMinpointWithValue(color, type, value)`

Legt die Mindestpunkte für den Gradienten in der Regel für die bedingte Formatierung fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red to green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die festzulegende Minimalpunktfarbe.
`type`	`InterpolationType`	Der festzulegende Minpoint-Interpolationstyp.
`value`	`String`	Der festzulegende Minimalwert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setItalic(italic)`

Legt kursiven Text für das Format der Regel für die bedingte Formatierung fest. Wenn italic den Wert true hat, Der Text wird durch die Regel kursiv dargestellt, wenn die Bedingung erfüllt ist. Wenn false, entfernt die Regel alle Kursivschreibung vorhanden, wenn die Bedingung erfüllt ist. Bei der Übergabe von null wird die Kursivschrift entfernt. Formateinstellung aus der Regel.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text italic if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setItalic(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`italic`	`Boolean`	Gibt an, ob der Text kursiv dargestellt werden soll, wenn die Formatbedingung erfüllt ist `null` entfernt diese Einstellung.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setRanges(ranges)`

Legt einen oder mehrere Bereiche fest, auf die diese Regel für die bedingte Formatierung angewendet wird. Dieser Vorgang ersetzt alle vorhandenen Bereiche. Wenn Sie ein leeres Array festlegen, werden alle vorhandenen Bereiche gelöscht. Eine Regel muss mindestens einen Bereich haben.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6
// to turn red if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`ranges`	`Range[]`	Die Bereiche, auf die diese Regel für die bedingte Formatierung angewendet wird.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setStrikethrough(strikethrough)`

Legt fest, dass Text für das Format der Regel für die bedingte Formatierung durchgestrichen wird. Wenn strikethrough gleich true: Der Text wird durch die Regel durchgestrichen, wenn die Bedingung erfüllt ist. Wenn false, gilt die Regel entfernt alle durchgestrichenen Formatierungen, wenn die Bedingung erfüllt ist. Bestanden in null wird das durchgestrichene Format aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setStrikethrough(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`strikethrough`	`Boolean`	Gibt an, ob der Text durchgestrichen werden soll, wenn die Formatbedingung wie folgt lautet: met; `null` entfernt diese Einstellung.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`setUnderline(underline)`

Legt Text für das Format der Regel für die bedingte Formatierung fest. Wenn underline den Wert true hat, wird Text unterstrichen, wenn die Bedingung erfüllt ist. Wenn false, entfernt die Regel alle werden unterstrichen, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Unterstreichung entfernt Formateinstellung aus der Regel.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`underline`	`Boolean`	Gibt an, ob der Text unterstrichen werden soll, wenn die Formatbedingung erfüllt ist; `null` entfernt diese Einstellung.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenCellEmpty()`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Zelle leer ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenCellNotEmpty()`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Zelle nicht leer ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are not empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenDateAfter(date)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum nach dem angegebenen Wert liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das späteste Datum.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenDateAfter(date)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum nach dem angegebenen relativen Datum liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das späteste Datum im Verhältnis zum ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenDateBefore(date)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum vor dem angegebenen Datum liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste inakzeptable Datum.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenDateBefore(date)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum vor dem angegebenen relativen Datum liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das späteste Datum im Verhältnis zum ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenDateEqualTo(date)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum mit dem angegebenen Datum übereinstimmt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the date 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das einzige zulässige Datum.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenDateEqualTo(date)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn ein Datum mit dem angegebenen relativen Datum übereinstimmt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain todays date.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das späteste Datum im Verhältnis zum ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenFormulaSatisfied(formula)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die angegebene Formel true ergibt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they satisfy the condition "=EQ(B4, C3)".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied("=EQ(B4, C3)")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`formula`	`String`	Eine benutzerdefinierte Formel, die `true` ergibt, wenn die Eingabe gültig ist.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberBetween(start, end)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl zwischen zwei oder einer von zwei liegt angegebenen Werten.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der niedrigste zulässige Wert.
`end`	`Number`	Der höchste akzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberEqualTo(number)`

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl gleich dem angegebenen Wert ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der einzige akzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberGreaterThan(number)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl größer als der angegebene Wert ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red
// if they contain a number greater than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste inakzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberGreaterThanOrEqualTo(number)`

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer oder gleich der angegebenen ist Wert.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number greater than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der niedrigste zulässige Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberLessThan(number)`

Legt die Regel für die bedingte bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl kleiner als die angegebene ist Wert.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der niedrigste inakzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberLessThanOrEqualTo(number)`

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner oder gleich der angegebenen Wert.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste akzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberNotBetween(start, end)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl nicht zwischen diesen liegt und keines von beiden ist zwei angegebenen Werte.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number not between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der niedrigste inakzeptable Wert.
`end`	`Number`	Der höchste inakzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenNumberNotEqualTo(number)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl ungleich dem angegebenen Wert ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der einzige inakzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenTextContains(text)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe den angegebenen Wert enthält.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextContains("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der Wert, den die Eingabe enthalten muss.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenTextDoesNotContain(text)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe das angegebene Wert.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextDoesNotContain("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der Wert, den die Eingabe nicht enthalten darf.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenTextEndsWith(text)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert endet.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they end with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, der mit dem Ende des Strings verglichen werden soll.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenTextEqualTo(text)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe dem angegebenen Wert entspricht.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they have text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der einzige akzeptable Wert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`whenTextStartsWith(text)`

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert beginnt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they start with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, der mit dem Anfang der Zeichenfolge verglichen werden soll.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen

`withCriteria(criteria, args)`

Legt die Regel für die bedingte Formatierung auf Kriterien fest, die durch BooleanCriteria-Werte definiert sind, normalerweise aus den criteria und arguments einer bestehenden Regel.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
var booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  var rule = SpreadsheetApp.newConditionalFormatRule()
      .withCriteria(booleanCondition.getCriteriaType(),
         booleanCondition.getCriteriaValues())
      .setBackground("#000000")
      .setRanges(rule.getRanges())
      .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`criteria`	`BooleanCriteria`	Der Typ der Kriterien für die bedingte Formatierung.
`args`	`Object[]`	Ein Array von Argumenten, die dem Kriterientyp entsprechen. die Anzahl der Argumente und Ihr Typ entspricht der entsprechenden `when...()`-Methode oben.

Rückflug

ConditionalFormatRuleBuilder – der Builder für Verkettungen