Kreator reguł formatowania warunkowego.
// 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);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | ConditionalFormatRule | Tworzy regułę formatowania warunkowego na podstawie ustawień zastosowanych do konstruktora. |
copy() | ConditionalFormatRuleBuilder | Zwraca gotowe konstruktor reguł z ustawieniami tej reguły. |
getBooleanCondition() | BooleanCondition | Pobiera informacje o regule BooleanCondition , jeśli ta reguła korzysta z:
kryterium warunku logicznego. |
getGradientCondition() | GradientCondition | Pobiera informacje o regule GradientCondition , jeśli ta reguła
korzysta z kryteriów warunku gradientu. |
getRanges() | Range[] | Pobiera zakresy, do których stosowana jest ta reguła formatowania warunkowego. |
setBackground(color) | ConditionalFormatRuleBuilder | Ustawia kolor tła formatu reguły formatowania warunkowego. |
setBackgroundObject(color) | ConditionalFormatRuleBuilder | Ustawia kolor tła formatu reguły formatowania warunkowego. |
setBold(bold) | ConditionalFormatRuleBuilder | Ustawia pogrubienie tekstu w formacie reguły formatowania warunkowego. |
setFontColor(color) | ConditionalFormatRuleBuilder | Ustawia kolor czcionki formatu reguły formatowania warunkowego. |
setFontColorObject(color) | ConditionalFormatRuleBuilder | Ustawia kolor czcionki formatu reguły formatowania warunkowego. |
setGradientMaxpoint(color) | ConditionalFormatRuleBuilder | Usuwa wartość maksymalnej liczby punktów gradientu reguły formatowania warunkowego, a zamiast tego używa maksymalnej wartości w zakresach reguły. |
setGradientMaxpointObject(color) | ConditionalFormatRuleBuilder | Usuwa wartość maksymalnej liczby punktów gradientu reguły formatowania warunkowego, a zamiast tego używa maksymalnej wartości w zakresach reguły. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Ustawia pola gradientu maxpoint w regule formatowania warunkowego. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Ustawia pola gradientu maxpoint w regule formatowania warunkowego. |
setGradientMidpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Ustawia pola gradientu punktu środkowego w regule formatowania warunkowego. |
setGradientMidpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Ustawia pola gradientu punktu środkowego w regule formatowania warunkowego. |
setGradientMinpoint(color) | ConditionalFormatRuleBuilder | Usuwa wartość minimalną gradientu reguły formatowania warunkowego, a zamiast tego używa minimalnej wartości w zakresach reguły. |
setGradientMinpointObject(color) | ConditionalFormatRuleBuilder | Usuwa wartość minimalną gradientu reguły formatowania warunkowego, a zamiast tego używa minimalnej wartości w zakresach reguły. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Ustawia pola gradientu w regule formatowania warunkowego. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Ustawia pola gradientu w regule formatowania warunkowego. |
setItalic(italic) | ConditionalFormatRuleBuilder | Ustawia kursywę tekstu w formacie reguły formatowania warunkowego. |
setRanges(ranges) | ConditionalFormatRuleBuilder | Ustawia co najmniej 1 zakres, do którego stosowana jest ta reguła formatowania warunkowego. |
setStrikethrough(strikethrough) | ConditionalFormatRuleBuilder | Ustawia przekreślenie tekstu w formacie reguły formatowania warunkowego. |
setUnderline(underline) | ConditionalFormatRuleBuilder | Ustawia podkreślenie tekstu dla formatu reguły formatowania warunkowego. |
whenCellEmpty() | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy komórka jest pusta. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy komórka nie jest pusta. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada po podanej wartości. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada po określonej dacie względnej. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada przed określoną datą. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada przed określoną datą względną. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest równa podanej dacie. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest równa podanej dacie względnej. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy podana formuła zwróci wartość true . |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba mieści się w zakresie 2 lub jest jednym z nich określonych wartości. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest równa podanej wartości. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest większa od podanej wartości. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest większa lub równa podanej . |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest mniejsza od podanej . |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest mniejsza lub równa podanej . |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy liczba nie mieści się między dwóch określonych wartości. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba nie jest równa podanej wartości. |
whenTextContains(text) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe zawierają określoną wartość. |
whenTextDoesNotContain(text) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe nie zawierają danej . |
whenTextEndsWith(text) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe kończą się określoną wartością. |
whenTextEqualTo(text) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy wartość wejściowa jest równa podanej wartości. |
whenTextStartsWith(text) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe zaczynają się od określonej wartości. |
withCriteria(criteria, args) | ConditionalFormatRuleBuilder | Ustawia regułę formatowania warunkowego na kryteria zdefiniowane przez wartości BooleanCriteria ,
zwykle pobierane z criteria i arguments
istniejącą regułę. |
Szczegółowa dokumentacja
build()
Tworzy regułę formatowania warunkowego na podstawie ustawień zastosowanych do konstruktora.
Powrót
ConditionalFormatRule
– reprezentacja reguły formatu warunkowego
copy()
Zwraca gotowe konstruktor reguł z ustawieniami tej reguły.
Powrót
ConditionalFormatRuleBuilder
– kreator oparty na ustawieniach tej reguły
getBooleanCondition()
Pobiera informacje o regule BooleanCondition
, jeśli ta reguła korzysta z:
kryterium warunku logicznego. W przeciwnym razie zwraca wartość null
.
// 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()); }
Powrót
BooleanCondition
– obiekt warunku logicznego lub null
, jeśli reguła nie korzysta z wartości logicznej;
.
getGradientCondition()
Pobiera informacje o regule GradientCondition
, jeśli ta reguła
korzysta z kryteriów warunku gradientu. W przeciwnym razie zwraca wartość null
.
// 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()); }
Powrót
GradientCondition
– obiekt warunku gradientu lub null
, jeśli reguła nie używa gradientu.
.
getRanges()
Pobiera zakresy, do których stosowana jest ta reguła formatowania warunkowego.
// 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()); }
Powrót
Range[]
– zakresy, do których stosowana jest ta reguła formatu warunkowego.
setBackground(color)
Ustawia kolor tła formatu reguły formatowania warunkowego. Zaliczenie za null
usuwa z reguły ustawienie formatu koloru tła.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Wybrany kolor lub kolor null do usunięcia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setBackgroundObject(color)
Ustawia kolor tła formatu reguły formatowania warunkowego. Zaliczenie za null
usuwa z reguły ustawienie formatu koloru tła.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Color | Żądany obiekt koloru lub null do usunięcia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów.
setBold(bold)
Ustawia pogrubienie tekstu w formacie reguły formatowania warunkowego. Jeśli bold
to true
,
reguła pogrubia tekst, jeśli warunek jest spełniony; jeśli false
, reguła usuwa wszystkie istniejące
możesz zastosować pogrubienie, jeśli warunek jest spełniony. Przekazanie null
powoduje usunięcie ustawienia pogrubionego formatu z:
reguły.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
bold | Boolean | Określa, czy tekst ma być pogrubiony, jeśli zostanie spełniony warunek formatu. null usuwa to ustawienie. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setFontColor(color)
Ustawia kolor czcionki formatu reguły formatowania warunkowego. Zaliczenie w null
powoduje usunięcie
ustawienia formatu koloru czcionki określonego w regule.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Wybrany kolor lub kolor null do usunięcia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setFontColorObject(color)
Ustawia kolor czcionki formatu reguły formatowania warunkowego. Zaliczenie w null
powoduje usunięcie
ustawienia formatu koloru czcionki określonego w regule.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Color | Żądany obiekt koloru lub null do usunięcia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów.
setGradientMaxpoint(color)
Usuwa wartość maksymalnej liczby punktów gradientu reguły formatowania warunkowego, a zamiast tego używa maksymalnej wartości w zakresach reguły. Ustawia też maksymalny kolor gradientu na kolor wejściowy.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kolor punktu maksymalnego do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setGradientMaxpointObject(color)
Usuwa wartość maksymalnej liczby punktów gradientu reguły formatowania warunkowego, a zamiast tego używa wartości maksymalnej w zakresach reguły. Ustawia też maksymalny kolor gradientu na kolor wejściowy.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Color | Obiekt koloru maxpoint do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów.
setGradientMaxpointObjectWithValue(color, type, value)
Ustawia pola gradientu maxpoint w regule formatowania warunkowego.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Color | Kolor punktu maksymalnego do ustawienia. |
type | InterpolationType | Typ interpolacji maksymalnej do ustawienia. |
value | String | Maksymalna wartość punktu do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów.
setGradientMaxpointWithValue(color, type, value)
Ustawia pola gradientu maxpoint w regule formatowania warunkowego.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kolor punktu maksymalnego do ustawienia. |
type | InterpolationType | Typ interpolacji maksymalnej do ustawienia. |
value | String | Maksymalna wartość punktu do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setGradientMidpointObjectWithValue(color, type, value)
Ustawia pola gradientu punktu środkowego w regule formatowania warunkowego. Usuwa wszystkie pola punktu środkowego
jeśli przekazany typ interpolacji to null
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on // their values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Color | Kolor punktu środkowego do ustawienia. |
type | InterpolationType | Typ interpolacji punktu środkowego, który należy ustawić, lub null , aby usunąć. |
value | String | Wartość środkowa do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów.
setGradientMidpointWithValue(color, type, value)
Ustawia pola gradientu punktu środkowego w regule formatowania warunkowego. Usuwa wszystkie pola punktu środkowego
jeśli przekazany typ interpolacji to null
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kolor punktu środkowego do ustawienia. |
type | InterpolationType | Typ interpolacji punktu środkowego, który należy ustawić, lub null , aby usunąć. |
value | String | Wartość środkowa do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setGradientMinpoint(color)
Usuwa wartość minimalną gradientu reguły formatowania warunkowego, a zamiast tego używa minimalnej wartości w zakresach reguły. Ustawia też kolor min. gradientu na kolor wejściowy.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kolor punktu minimalnej do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setGradientMinpointObject(color)
Usuwa wartość minimalną gradientu reguły formatowania warunkowego, a zamiast tego używa minimalnej wartości w zakresach reguły. Ustawia też kolor min. gradientu na kolor wejściowy.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Color | Obiekt koloru punktu minimalnej do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów.
setGradientMinpointObjectWithValue(color, type, value)
Ustawia pola gradientu w regule formatowania warunkowego.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | Color | Kolor punktu minimalnej do ustawienia. |
type | InterpolationType | Typ interpolacji punktu min. do ustawienia. |
value | String | Wartość minimalna do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów.
setGradientMinpointWithValue(color, type, value)
Ustawia pola gradientu w regule formatowania warunkowego.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | Kolor punktu minimalnej do ustawienia. |
type | InterpolationType | Typ interpolacji punktu min. do ustawienia. |
value | String | Wartość minimalna do ustawienia. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setItalic(italic)
Ustawia kursywę tekstu w formacie reguły formatowania warunkowego. Jeśli italic
to true
,
jeśli zostanie spełniony warunek wyróżniony kursywą w tekście, jeśli false
, reguła usuwa wszystkie
kursywy, jeśli jest spełniony warunek. Zaliczenie null
eliminuje kursywę
ustawienia formatu z reguły.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
italic | Boolean | Określa, czy tekst ma zostać pochylony, jeśli zostanie spełniony warunek formatowania.
null usuwa to ustawienie. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setRanges(ranges)
Ustawia co najmniej 1 zakres, do którego stosowana jest ta reguła formatowania warunkowego. Ta operacja zastępuje wszystkie istniejące zakresy. Ustawienie pustej tablicy powoduje wyczyszczenie wszystkich istniejących zakresów. Reguła musi mają co najmniej jeden zakres.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
ranges | Range[] | Zakresy, do których stosowana jest ta reguła formatu warunkowego. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setStrikethrough(strikethrough)
Ustawia przekreślenie tekstu w formacie reguły formatowania warunkowego. Jeśli strikethrough
to
true
, reguła przekreśla tekst, jeśli warunek jest spełniony; jeśli false
, to reguła
jeśli warunek zostanie spełniony, spowoduje to usunięcie istniejącego przekreślenia. Zaliczenie za null
spowoduje usunięcie ustawienia przekreślenia z reguły.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
strikethrough | Boolean | Określa, czy tekst ma być przekreślony, jeśli warunek formatu to
met; null usuwa to ustawienie. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
setUnderline(underline)
Ustawia podkreślenie tekstu dla formatu reguły formatowania warunkowego. Jeśli underline
to true
, reguła podkreśla tekst w przypadku spełnienia warunku. jeśli false
, reguła usuwa wszystkie
jest podkreślane, jeśli warunek jest spełniony. Zaliczenie null
powoduje usunięcie podkreślenia
ustawienia formatu z reguły.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
underline | Boolean | Określa, czy tekst ma być podkreślony, jeśli zostanie spełniony warunek formatu.
null usuwa to ustawienie. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenCellEmpty()
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy komórka jest pusta.
// 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);
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenCellNotEmpty()
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy komórka nie jest pusta.
// 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);
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenDateAfter(date)
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada po podanej wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najnowsza data. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenDateAfter(date)
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada po określonej dacie względnej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Najnowsza data w stosunku do wybranego typu daty. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenDateBefore(date)
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada przed określoną datą.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najwcześniejsza niedopuszczalna data. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenDateBefore(date)
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada przed określoną datą względną.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Najnowsza data w stosunku do wybranego typu daty. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenDateEqualTo(date)
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest równa podanej dacie.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | Jedyna dopuszczalna data. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenDateEqualTo(date)
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest równa podanej dacie względnej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Najnowsza data w stosunku do wybranego typu daty. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenFormulaSatisfied(formula)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy podana formuła zwróci wartość true
.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Formuła niestandardowa, która zwraca wartość true , jeśli dane wejściowe są prawidłowe. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberBetween(start, end)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba mieści się w zakresie 2 lub jest jednym z nich określonych wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa akceptowana wartość. |
end | Number | Najwyższa akceptowalna wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberEqualTo(number)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest równa podanej wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Jedyna akceptowana wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberGreaterThan(number)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest większa od podanej wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyższa niedopuszczalna wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberGreaterThanOrEqualTo(number)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest większa lub równa podanej .
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa akceptowana wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberLessThan(number)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest mniejsza od podanej .
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa niedopuszczalna wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberLessThanOrEqualTo(number)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest mniejsza lub równa podanej .
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyższa akceptowalna wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberNotBetween(start, end)
Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy liczba nie mieści się między dwóch określonych wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa niedopuszczalna wartość. |
end | Number | Najwyższa niedopuszczalna wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenNumberNotEqualTo(number)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba nie jest równa podanej wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
number | Number | Jedyna niedopuszczalna wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenTextContains(text)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe zawierają określoną wartość.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Wartość, która musi zawierać dane wejściowe. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenTextDoesNotContain(text)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe nie zawierają danej .
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Wartość, której dane wejściowe nie mogą zawierać. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenTextEndsWith(text)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe kończą się określoną wartością.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który ma być porównywany z końcem ciągu znaków. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenTextEqualTo(text)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy wartość wejściowa jest równa podanej wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Jedyna akceptowana wartość. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
whenTextStartsWith(text)
Ustawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe zaczynają się od określonej wartości.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który ma być porównywany z początkiem ciągu znaków. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów
withCriteria(criteria, args)
Ustawia regułę formatowania warunkowego na kryteria zdefiniowane przez wartości BooleanCriteria
,
zwykle pobierane z criteria
i arguments
istniejącą regułę.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
criteria | BooleanCriteria | Typ kryteriów formatowania warunkowego. |
args | Object[] | Tablica argumentów odpowiednich do typu kryterium; liczbę argumentów
ich typ pasują do odpowiedniej metody when...() powyżej. |
Powrót
ConditionalFormatRuleBuilder
– kreator łańcuchów