Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

Builder 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 das bedingte Format aus den Einstellungen, die auf den Builder angewendet werden.
copy()	ConditionalFormatRuleBuilder	Gibt eine voreingestellte Regelerstellung mit den Einstellungen dieser Regel zurück.
getBooleanCondition()	BooleanCondition	Ruft die BooleanCondition-Informationen der Regel ab, wenn in dieser Regel boolesche Bedingungskriterien verwendet werden.
getGradientCondition()	GradientCondition	Ruft die GradientCondition-Informationen der Regel ab, wenn in dieser Regel Kriterien für den Verlauf der Bedingung verwendet werden.
getRanges()	Range[]	Ruft die Bereiche ab, auf die diese bedingte Formatregel angewendet wird.
setBackground(color)	ConditionalFormatRuleBuilder	Legt die Hintergrundfarbe der Regel für die bedingte Formatierung fest.
setBackgroundObject(color)	ConditionalFormatRuleBuilder	Legt die Hintergrundfarbe der Regel für die bedingte Formatierung fest.
setBold(bold)	ConditionalFormatRuleBuilder	Legt die Fettformatierung für das Format der bedingten Formatregel fest.
setFontColor(color)	ConditionalFormatRuleBuilder	Legt die Schriftfarbe für das Format der bedingten Formatregel fest.
setFontColorObject(color)	ConditionalFormatRuleBuilder	Legt die Schriftfarbe für das Format der bedingten Formatregel fest.
setGradientMaxpoint(color)	ConditionalFormatRuleBuilder	Löscht den Gradienten für den Gradienten der bedingten Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel.
setGradientMaxpointObject(color)	ConditionalFormatRuleBuilder	Löscht den Gradienten für den Gradienten der bedingten Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel.
setGradientMaxpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für die Gradientenmaximierung mit bedingter Formatierung fest.
setGradientMaxpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für die Gradientenmaximierung mit bedingter Formatierung fest.
setGradientMidpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Gradienten der bedingten Formatregel fest.
setGradientMidpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Gradienten der bedingten Formatregel fest.
setGradientMinpoint(color)	ConditionalFormatRuleBuilder	Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel.
setGradientMinpointObject(color)	ConditionalFormatRuleBuilder	Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel.
setGradientMinpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Gradienten der bedingten Formatregel in Gradienten fest.
setGradientMinpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Gradienten der bedingten Formatregel in Gradienten fest.
setItalic(italic)	ConditionalFormatRuleBuilder	Text kursiv für das Format der bedingten Formatregel.
setRanges(ranges)	ConditionalFormatRuleBuilder	Legt einen oder mehrere Bereiche fest, auf die diese bedingte Formatregel angewendet wird.
setStrikethrough(strikethrough)	ConditionalFormatRuleBuilder	Textdurchstreichen für das Format der bedingten Formatregel.
setUnderline(underline)	ConditionalFormatRuleBuilder	Legt den unterstrichenen Text für das Format der bedingten Formatregel fest.
whenCellEmpty()	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Zelle leer ist.
whenCellNotEmpty()	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Zelle nicht leer ist.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum nach dem angegebenen Wert liegt.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum nach dem angegebenen relativen Datum liegt.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum vor dem angegebenen Datum liegt.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum vor dem angegebenen relativen Datum liegt.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum dem angegebenen Datum entspricht.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum dem angegebenen relativen Datum entspricht.
whenFormulaSatisfied(formula)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die angegebene Formel true ergibt.
whenNumberBetween(start, end)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einen dieser Werte erfüllt.
whenNumberEqualTo(number)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl dem angegebenen Wert entspricht.
whenNumberGreaterThan(number)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl größer als der angegebene Wert ist.
whenNumberGreaterThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl größer oder gleich dem angegebenen Wert ist.
whenNumberLessThan(number)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl kleiner als der angegebene Wert ist.
whenNumberLessThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl kleiner oder gleich dem angegebenen Wert ist.
whenNumberNotBetween(start, end)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt und keiner dieser Werte entspricht.
whenNumberNotEqualTo(number)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl nicht dem angegebenen Wert entspricht.
whenTextContains(text)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Eingabe den angegebenen Wert enthält.
whenTextDoesNotContain(text)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Eingabe nicht den angegebenen Wert enthält.
whenTextEndsWith(text)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert endet.
whenTextEqualTo(text)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Eingabe gleich dem angegebenen Wert ist.
whenTextStartsWith(text)	ConditionalFormatRuleBuilder	Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert beginnt.
withCriteria(criteria, args)	ConditionalFormatRuleBuilder	Legt die bedingte Formatregel auf Kriterien fest, die durch BooleanCriteria-Werte definiert sind. Diese werden normalerweise aus den criteria und arguments einer vorhandenen Regel übernommen.

Detaillierte Dokumentation

build()

Erstellt eine Regel für das bedingte Format aus den Einstellungen, die auf den Builder angewendet werden.

Zurücksenden

ConditionalFormatRule: Darstellung der bedingten Formatregel

---

copy()

Gibt eine voreingestellte Regelerstellung mit den Einstellungen dieser Regel zurück.

Zurücksenden

ConditionalFormatRuleBuilder: Ein Builder, der auf den Einstellungen dieser Regel basiert

---

getBooleanCondition()

Ruft die BooleanCondition-Informationen der Regel ab, wenn in dieser Regel boolesche Bedingungskriterien verwendet werden. 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());
}

Zurücksenden

BooleanCondition: Das boolesche Bedingungsobjekt oder null, wenn die Regel keine boolesche Bedingung verwendet.

---

getGradientCondition()

Ruft die GradientCondition-Informationen der Regel ab, wenn in dieser Regel Kriterien für den Verlauf der Bedingung verwendet werden. 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());
}

Zurücksenden

GradientCondition: Das Gradientenbedingungsobjekt oder null, wenn die Regel keine Gradientenbedingung verwendet.

---

getRanges()

Ruft die Bereiche ab, auf die diese bedingte Formatregel 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());
}

Zurücksenden

Range[]: Die Bereiche, auf die diese bedingte Formatregel angewendet wird.

---

setBackground(color)

Legt die Hintergrundfarbe der Regel für die bedingte Formatierung fest. Durch die Übergabe von 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 zum Löschen.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setBackgroundObject(color)

Legt die Hintergrundfarbe der Regel für die bedingte Formatierung fest. Durch die Übergabe von 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.

Zurücksenden

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setBold(bold)

Legt die Fettformatierung für das Format der bedingten Formatregel fest. Wenn bold den Wert true hat, wird die Regel in Fettdruck angezeigt, wenn die Bedingung erfüllt ist. Wenn false ist, entfernt die Regel alle vorhandenen Fettformatierung, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die fett formatierte Einstellung aus der Regel entfernt.

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

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setFontColor(color)

Legt die Schriftfarbe für das Format der bedingten Formatregel fest. Durch die Übergabe von null wird die Einstellung für das Schriftfarbenformat aus der Regel entfernt.

// 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 zum Löschen.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setFontColorObject(color)

Legt die Schriftfarbe für das Format der bedingten Formatregel fest. Durch die Übergabe von null wird die Einstellung für das Schriftfarbenformat aus der Regel entfernt.

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

Zurücksenden

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMaxpoint(color)

Löscht den Gradienten für den Gradienten der bedingten Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. Legt außerdem die Maxpoint-Farbe des Farbverlaufs auf die Eingabefarbe fest.

// 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 Höchstpunktfarbe.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setGradientMaxpointObject(color)

Löscht den Gradienten für den Gradienten der bedingten Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. Legt außerdem die Maxpoint-Farbe des Farbverlaufs auf die Eingabefarbe fest.

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

Zurücksenden

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMaxpointObjectWithValue(color, type, value)

Legt die Felder für die Gradientenmaximierung mit bedingter 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 Höchstpunktfarbe.
type	InterpolationType	Der festzulegende maxpoint interpolation-Typ.
value	String	Der festzulegende Maximalwert.

Zurücksenden

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMaxpointWithValue(color, type, value)

Legt die Felder für die Gradientenmaximierung mit bedingter 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 Höchstpunktfarbe.
type	InterpolationType	Der festzulegende maxpoint interpolation-Typ.
value	String	Der festzulegende Maximalwert.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setGradientMidpointObjectWithValue(color, type, value)

Legt die Felder für den Gradienten der bedingten Formatregel fest. Löscht alle Mittelpunktfelder, wenn der übergebene Interpoltyp null ist.

// 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 Mittelpunktfarbe.
type	InterpolationType	Der Typ der Mittelpunkt-Interpolation, der festgelegt werden soll, oder null, der gelöscht werden soll.
value	String	Der festzulegende Mittelpunktwert.

Zurücksenden

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMidpointWithValue(color, type, value)

Legt die Felder für den Gradienten der bedingten Formatregel fest. Löscht alle Mittelpunktfelder, wenn der übergebene Interpoltyp null ist.

// 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 Mittelpunktfarbe.
type	InterpolationType	Der Typ der Mittelpunkt-Interpolation, der festgelegt werden soll, oder null, der gelöscht werden soll.
value	String	Der festzulegende Mittelpunktwert.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setGradientMinpoint(color)

Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel. Legt außerdem die Mindestpunktfarbe für den Farbverlauf auf die Eingabefarbe fest.

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

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setGradientMinpointObject(color)

Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Mindestwert in den Bereichen der Regel. Legt außerdem die Mindestpunktfarbe für den Farbverlauf auf die Eingabefarbe fest.

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

Zurücksenden

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMinpointObjectWithValue(color, type, value)

Legt die Felder für den Gradienten der bedingten Formatregel in Gradienten 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 Punktfarbe.
type	InterpolationType	Der festzulegende Minimalinterpolationstyp.
value	String	Der festzulegende Minimalwert.

Zurücksenden

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMinpointWithValue(color, type, value)

Legt die Felder für den Gradienten der bedingten Formatregel in Gradienten 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 Punktfarbe.
type	InterpolationType	Der festzulegende Minimalinterpolationstyp.
value	String	Der festzulegende Minimalwert.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setItalic(italic)

Text kursiv für das Format der bedingten Formatregel. Ist italic auf true gesetzt, wird durch die Regel Text kursiv dargestellt, wenn die Bedingung erfüllt ist. Bei false wird die vorhandene Kursivschrift entfernt, wenn die Bedingung erfüllt ist. Durch die Übergabe von null wird die Kursivformateinstellung aus der Regel entfernt.

// 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 sein soll, wenn die Formatbedingung erfüllt ist. null entfernt diese Einstellung.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setRanges(ranges)

Legt einen oder mehrere Bereiche fest, auf die diese bedingte Formatregel 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 bedingte Formatregel angewendet wird.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setStrikethrough(strikethrough)

Textdurchstreichen für das Format der bedingten Formatregel. Wenn strikethrough den Wert true hat, ist die Regel durchgestrichen, wenn die Bedingung erfüllt ist. Bei false wird die vorhandene Formatierung durchgestrichen, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die durchgestrichene Formateinstellung 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 sein soll, wenn die Formatbedingung erfüllt ist. null entfernt diese Einstellung.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

setUnderline(underline)

Legt den unterstrichenen Text für das Format der bedingten Formatregel fest. Ist underline auf true gesetzt, wird der Text durch die Regel unterstrichen, wenn die Bedingung erfüllt ist. Bei false werden alle vorhandenen Unterstreichungen entfernt, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Formatierung des Unterstrichen aus der Regel entfernt.

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

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenCellEmpty()

Legt die Regel für das bedingte Format 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);

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenCellNotEmpty()

Legt die Regel für das bedingte Format 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);

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenDateAfter(date)

Legt die Regel für das bedingte Format 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenDateAfter(date)

Legt die Regel für das bedingte Format 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 letzte Datum im Verhältnis zum ausgewählten Datumstyp.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenDateBefore(date)

Legt die Regel für das bedingte Format 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenDateBefore(date)

Legt die Regel für das bedingte Format 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 letzte Datum im Verhältnis zum ausgewählten Datumstyp.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenDateEqualTo(date)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum dem angegebenen Datum entspricht.

// 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 akzeptable Datum.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenDateEqualTo(date)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn ein Datum dem angegebenen relativen Datum entspricht.

// 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 letzte Datum im Verhältnis zum ausgewählten Datumstyp.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenFormulaSatisfied(formula)

Legt die Regel für das bedingte Format 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 ausgewertet wird, wenn die Eingabe gültig ist.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberBetween(start, end)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einen dieser Werte erfüllt.

// 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 zulässige Wert.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberEqualTo(number)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl dem angegebenen Wert entspricht.

// 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 zulässige Wert.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberGreaterThan(number)

Legt die Regel für das bedingte Format 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberGreaterThanOrEqualTo(number)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl größer oder 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 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberLessThan(number)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl kleiner 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 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberLessThanOrEqualTo(number)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl kleiner oder 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 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 zulässige Wert.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberNotBetween(start, end)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt und keiner dieser Werte entspricht.

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

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenNumberNotEqualTo(number)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn eine Zahl nicht dem angegebenen Wert entspricht.

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

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenTextContains(text)

Legt die Regel für das bedingte Format 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenTextDoesNotContain(text)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Eingabe nicht 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 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenTextEndsWith(text)

Legt die Regel für das bedingte Format 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.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenTextEqualTo(text)

Legt die Regel für das bedingte Format fest, die ausgelöst wird, wenn die Eingabe 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 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 zulässige Wert.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

whenTextStartsWith(text)

Legt die Regel für das bedingte Format 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 des Strings verglichen werden soll.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten

---

withCriteria(criteria, args)

Legt die bedingte Formatregel auf Kriterien fest, die durch BooleanCriteria-Werte definiert sind. Diese werden normalerweise aus den criteria und arguments einer vorhandenen Regel übernommen.

// 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 das bedingte Format.
args	Object[]	Ein Array von Argumenten, die dem Kriterientyp entsprechen. Die Anzahl der Argumente und ihr Typ entsprechen der entsprechenden Methode when...() oben.

Zurücksenden

ConditionalFormatRuleBuilder: der Builder zum Verketten