Builder für Regeln zur bedingten 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 werden. |
copy() | ConditionalFormatRuleBuilder | Gibt eine Voreinstellung zur Regelerstellung mit den Einstellungen dieser Regel zurück. |
getBooleanCondition() | BooleanCondition | Ruft die BooleanCondition -Informationen der Regel ab, wenn diese Regel boolesche Bedingungskriterien verwendet. |
getGradientCondition() | GradientCondition | Ruft die GradientCondition -Informationen der Regel ab, wenn diese Regel Gradientenbedingungskriterien verwendet. |
getRanges() | Range[] | Ruft die Bereiche ab, auf die diese Regel zur bedingten 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 die Fettformatierung für das Format der bedingten Formatierungsregel fest. |
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 Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. |
setGradientMaxpointObject(color) | ConditionalFormatRuleBuilder | Löscht den Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Legt die Gradienten-Maximalpunktfelder der Regel für die bedingte Formatierung fest. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Legt die Gradienten-Maximalpunktfelder der Regel für die bedingte Formatierung fest. |
setGradientMidpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Legt die Felder für den Gradientenmittelpunkt der bedingten Formatierung fest. |
setGradientMidpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Legt die Felder für den Gradientenmittelpunkt der bedingten 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. |
setGradientMinpointObject(color) | ConditionalFormatRuleBuilder | Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Legt die Gradientenminpoint-Felder der Regel für die bedingte Formatierung fest. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Legt die Gradientenminpoint-Felder der Regel für die bedingte Formatierung fest. |
setItalic(italic) | ConditionalFormatRuleBuilder | Legt Text kursiv 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 | Hiermit wird der Text für das Format der Regel für die bedingte Formatierung durchgestrichen. |
setUnderline(underline) | ConditionalFormatRuleBuilder | Legt Text unterstrichen für das Format der Regel für die bedingte Formatierung fest. |
whenCellEmpty() | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle leer ist. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle nicht leer ist. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen Wert liegt. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen relativen Datum liegt. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen Datum liegt. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen relativen Datum liegt. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen Datum entspricht. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen relativen Datum entspricht. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die angegebene Formel true ergibt. |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einer dieser Werte ist. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl dem angegebenen Wert entspricht. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer als der angegebene Wert ist. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl größer oder gleich dem angegebenen Wert ist. |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner als der angegebene Wert ist. |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl kleiner oder gleich dem angegebenen Wert ist. |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt oder keiner dieser Werte ist. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht dem angegebenen Wert entspricht. |
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 den angegebenen Wert nicht enthält. |
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, die in der Regel aus criteria und arguments einer vorhandenen Regel übernommen werden. |
Detaillierte Dokumentation
build()
Erstellt eine Regel für die bedingte Formatierung aus den Einstellungen, die auf den Builder angewendet werden.
Return
ConditionalFormatRule
: Eine Darstellung der Regel für die bedingte Formatierung
copy()
Gibt eine Voreinstellung zur Regelerstellung mit den Einstellungen dieser Regel zurück.
Return
ConditionalFormatRuleBuilder
– ein Builder, der auf den Einstellungen dieser Regel basiert
getBooleanCondition()
Ruft die BooleanCondition
-Informationen der Regel ab, wenn diese Regel boolesche Bedingungskriterien verwendet. Andernfalls wird null
zurückgegeben.
// Log the boolean criteria type of the first conditional format rules of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
Return
BooleanCondition
: das boolesche Bedingungsobjekt oder null
, wenn die Regel keine boolesche Bedingung verwendet
getGradientCondition()
Ruft die GradientCondition
-Informationen der Regel ab, wenn diese Regel Gradientenbedingungskriterien verwendet. 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()); }
Return
GradientCondition
: das Verlaufsbedingungsobjekt oder null
, wenn in der Regel keine Gradientenbedingung verwendet wird
getRanges()
Ruft die Bereiche ab, auf die diese Regel zur bedingten 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()); }
Return
Range[]
: Die Bereiche, auf die diese Regel zur bedingten Formatierung angewendet wird.
setBackground(color)
Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null
übergeben, wird die Einstellung für die Hintergrundfarbe 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setBackgroundObject(color)
Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null
übergeben, wird die Einstellung für die Hintergrundfarbe 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 zu löschende Farbobjekt oder null . |
Return
ConditionalFormatRuleBuilder
: Der Builder für die Verkettung.
setBold(bold)
Legt die Fettformatierung für das Format der bedingten Formatierungsregel fest. Wenn bold
den Wert true
hat, wird Text in der Regel fett formatiert, wenn die Bedingung erfüllt ist. Wenn false
, entfernt die Regel alle vorhandenen Fettdrucke, wenn die Bedingung erfüllt ist. Wenn Sie null
übergeben, wird die Einstellung für die Fettformatierung 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 Formatierungsbedingung erfüllt ist; null entfernt diese Einstellung. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setFontColor(color)
Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null
übergeben, wird die Einstellung für die Schriftfarbe 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setFontColorObject(color)
Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null
übergeben, wird die Einstellung für die Schriftfarbe 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 zu löschende Farbobjekt oder null . |
Return
ConditionalFormatRuleBuilder
: Der Builder für die Verkettung.
setGradientMaxpoint(color)
Löscht den Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. Außerdem wird die Höchstpunktfarbe 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 Höchstpunktfarbe. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setGradientMaxpointObject(color)
Löscht den Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. Außerdem wird die Höchstpunktfarbe 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 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 Farbobjekt für den Höchstwert. |
Return
ConditionalFormatRuleBuilder
: Der Builder für die Verkettung.
setGradientMaxpointObjectWithValue(color, type, value)
Legt die Gradienten-Maximalpunktfelder 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 Höchstpunktfarbe. |
type | InterpolationType | Der festzulegende Höchstwertinterpolationstyp. |
value | String | Der Höchstwert, der festgelegt werden soll. |
Return
ConditionalFormatRuleBuilder
: Der Builder für die Verkettung.
setGradientMaxpointWithValue(color, type, value)
Legt die Gradienten-Maximalpunktfelder 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 Höchstpunktfarbe. |
type | InterpolationType | Der festzulegende Höchstwertinterpolationstyp. |
value | String | Der Höchstwert, der festgelegt werden soll. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setGradientMidpointObjectWithValue(color, type, value)
Legt die Felder für den Gradientenmittelpunkt der bedingten Formatierung fest. Löscht alle Mittelpunktfelder, wenn der als Interpolationstyp übergebene Wert 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 Mittelpunktfarbe, die festgelegt werden soll. |
type | InterpolationType | Der festzulegende Mittelwertinterpolationstyp oder null zum Löschen. |
value | String | Der festzulegende Mittelpunktwert. |
Return
ConditionalFormatRuleBuilder
: Der Builder für die Verkettung.
setGradientMidpointWithValue(color, type, value)
Legt die Felder für den Gradientenmittelpunkt der bedingten Formatierung fest. Löscht alle Mittelpunktfelder, wenn der als Interpolationstyp übergebene Wert 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 Mittelpunktfarbe, die festgelegt werden soll. |
type | InterpolationType | Der festzulegende Mittelwertinterpolationstyp oder null zum Löschen. |
value | String | Der festzulegende Mittelpunktwert. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setGradientMinpoint(color)
Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel. Legt außerdem die Minpoint-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 Mindestpunktfarbe. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setGradientMinpointObject(color)
Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel. Legt außerdem die Minpoint-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 Minpoint-Farbobjekt. |
Return
ConditionalFormatRuleBuilder
: Der Builder für die Verkettung.
setGradientMinpointObjectWithValue(color, type, value)
Legt die Gradientenminpoint-Felder 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 Mindestpunktfarbe. |
type | InterpolationType | Der festzulegende Minpoint-Interpolationstyp. |
value | String | Der festzulegende Mindestwert. |
Return
ConditionalFormatRuleBuilder
: Der Builder für die Verkettung.
setGradientMinpointWithValue(color, type, value)
Legt die Gradientenminpoint-Felder 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 Mindestpunktfarbe. |
type | InterpolationType | Der festzulegende Minpoint-Interpolationstyp. |
value | String | Der festzulegende Mindestwert. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setItalic(italic)
Legt Text kursiv für das Format der Regel für die bedingte Formatierung fest. Wenn für italic
der Wert true
gilt, wird Text in der Regel kursiv gesetzt, wenn die Bedingung erfüllt ist. Bei false
entfernt die Regel vorhandene Kursivschrift, wenn die Bedingung erfüllt ist. Wenn Sie null
übergeben, wird die Einstellung für den Kursivformat 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 dargestellt werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit null wird diese Einstellung entfernt. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setRanges(ranges)
Legt einen oder mehrere Bereiche fest, auf die diese Regel für die bedingte Formatierung angewendet wird. Durch diesen Vorgang werden alle vorhandenen Bereiche ersetzt. Durch das Festlegen eines leeren Arrays 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 zur bedingten Formatierung angewendet wird. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setStrikethrough(strikethrough)
Hiermit wird der Text für das Format der Regel für die bedingte Formatierung durchgestrichen. Wenn strikethrough
den Wert true
hat, wird durch die Regel der Text durchgestrichen, wenn die Bedingung erfüllt ist. Wenn die Bedingung false
erfüllt ist, werden alle vorhandenen durchgestrichenen Formatierungen entfernt. Wenn Sie null
übergeben, wird die Einstellung für 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 erfüllt ist; null entfernt diese Einstellung. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
setUnderline(underline)
Legt Text unterstrichen für das Format der Regel für die bedingte Formatierung fest. Wenn underline
den Wert true
hat, unterstreicht die Regel Text, wenn die Bedingung erfüllt ist. Wenn false
, entfernt die Regel alle vorhandenen Unterstreichungen, wenn die Bedingung erfüllt ist. Wenn Sie null
übergeben, wird die Einstellung für das Unterstreichen 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 Formatierungsbedingung erfüllt ist; null entfernt diese Einstellung. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenCellEmpty()
Legt fest, dass die Regel für die bedingte Formatierung 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);
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenCellNotEmpty()
Legt fest, dass die Regel für die bedingte Formatierung 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);
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenDateAfter(date)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenDateAfter(date)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenDateBefore(date)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenDateBefore(date)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenDateEqualTo(date)
Legt fest, dass die Regel für die bedingte Formatierung 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 zulässige Datum. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenDateEqualTo(date)
Legt fest, dass die Regel für die bedingte Formatierung 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 späteste Datum im Verhältnis zum ausgewählten Datumstyp. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenFormulaSatisfied(formula)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberBetween(start, end)
Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einer dieser Werte ist.
// 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 akzeptable Wert. |
end | Number | Der höchste akzeptable Wert. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberEqualTo(number)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberGreaterThan(number)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberGreaterThanOrEqualTo(number)
Legt die Regel für die bedingte Formatierung 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 akzeptable Wert. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberLessThan(number)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberLessThanOrEqualTo(number)
Legt die Regel für die bedingte Formatierung 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 akzeptable Wert. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberNotBetween(start, end)
Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt oder keiner dieser Werte ist.
// 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenNumberNotEqualTo(number)
Legt fest, dass die Regel für die bedingte Formatierung 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
whenTextDoesNotContain(text)
Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe den angegebenen Wert nicht 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. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
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 |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
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 zulässige Wert. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
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 des Strings verglichen werden soll |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung
withCriteria(criteria, args)
Legt die Regel für die bedingte Formatierung auf Kriterien fest, die durch BooleanCriteria
-Werte definiert sind, die in der Regel aus criteria
und arguments
einer vorhandenen Regel übernommen werden.
// 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 des Kriteriums für die bedingte Formatierung. |
args | Object[] | Ein Array mit Argumenten entsprechend dem Kriterientyp. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden when...() -Methode oben überein. |
Return
ConditionalFormatRuleBuilder
: der Builder für die Verkettung