Class ConditionalFormatRuleBuilder

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
ConditionalFormatRuleBuilder

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

MetodaZwracany typKrótki opis
build()ConditionalFormatRuleTworzy regułę formatowania warunkowego z ustawień zastosowanych w konstruktorze.
copy()ConditionalFormatRuleBuilderZwraca gotowe ustawienia konstruktora reguł z ustawieniami tej reguły.
getBooleanCondition()BooleanConditionPobiera informacje o zasadzie BooleanCondition, jeśli ta reguła używa kryteriów warunku logicznego.
getGradientCondition()GradientConditionPobiera informacje o regule GradientCondition, jeśli korzysta ona z kryteriów warunku gradientu.
getRanges()Range[]Pobiera zakresy, do których stosowana jest ta reguła warunkowa.
setBackground(color)ConditionalFormatRuleBuilderUstawia kolor tła reguły formatowania warunkowego.
setBackgroundObject(color)ConditionalFormatRuleBuilderUstawia kolor tła reguły formatowania warunkowego.
setBold(bold)ConditionalFormatRuleBuilderUstawia pogrubienie tekstu w regule formatu warunkowego.
setFontColor(color)ConditionalFormatRuleBuilderUstawia kolor czcionki w formacie reguły warunkowej.
setFontColorObject(color)ConditionalFormatRuleBuilderUstawia kolor czcionki w formacie reguły warunkowej.
setGradientMaxpoint(color)ConditionalFormatRuleBuilderCzyści wartość maksymalnego punktu gradientu reguły warunkowej i zamiast niej używa wartości maksymalnej z zakresów reguły.
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderCzyści wartość maksymalnego punktu gradientu reguły warunkowej i zamiast niej używa wartości maksymalnej z zakresów reguły.
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pola formatowania punktowego gradientu warunkowego formatu warunkowego.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pola formatowania punktowego gradientu warunkowego formatu warunkowego.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pole warunkowego reguły formatowania warunkowego.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pole warunkowego reguły formatowania warunkowego.
setGradientMinpoint(color)ConditionalFormatRuleBuilderCzyści regułę wartości warunkowej reguły warunkowej i zamiast niej używa wartości minimalnej w zakresach reguł.
setGradientMinpointObject(color)ConditionalFormatRuleBuilderCzyści regułę wartości warunkowej reguły warunkowej i zamiast niej używa wartości minimalnej w zakresach reguł.
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pole warunkowego reguły formatowania warunkowego.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pole warunkowego reguły formatowania warunkowego.
setItalic(italic)ConditionalFormatRuleBuilderUstawia kursywę tekstu w formacie reguły warunkowej.
setRanges(ranges)ConditionalFormatRuleBuilderUstawia co najmniej 1 zakres, do którego ma zastosowanie ta reguła warunkowa.
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderUstawia przekreślenie tekstu w formacie reguły warunkowej.
setUnderline(underline)ConditionalFormatRuleBuilderUstawia podkreślenie tekstu w formacie reguły warunkowej.
whenCellEmpty()ConditionalFormatRuleBuilderUstawia regułę warunkową, która ma być aktywowana, gdy komórka jest pusta.
whenCellNotEmpty()ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, gdy komórka nie jest pusta.
whenDateAfter(date)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która ma być aktywowana, gdy data przypada po określonej wartości.
whenDateAfter(date)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy data przypada po określonej dacie względnej.
whenDateBefore(date)ConditionalFormatRuleBuilderUstawia regułę warunkową, która ma być aktywowana, gdy data przypada przed określoną datą.
whenDateBefore(date)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy data jest wcześniejsza od określonej daty względnej.
whenDateEqualTo(date)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy data jest równa danej dacie.
whenDateEqualTo(date)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy data jest równa określonej dacie względnej.
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderUstawia regułę warunkową, która ma być aktywowana, gdy dana formuła zwróci wartość true.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderUstawia regułę formatu warunkowego, która będzie się uruchamiać, gdy liczba mieści się w zakresie lub między tymi wartościami.
whenNumberEqualTo(number)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy liczba jest równa danej wartości.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy liczba jest większa od podanej wartości.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy liczba jest większa od wartości podanej lub jej równa.
whenNumberLessThan(number)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy liczba jest mniejsza od podanej wartości.
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderUstawia regułę formatu warunkowego, która będzie się uruchamiać, gdy liczba różni się od podanej wartości lub jej równa.
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy liczba nie mieści się w zakresie i nie jest jedną z 2 określonych wartości.
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderUstawia regułę warunkową, która ma być aktywowana, gdy liczba różni się od określonej wartości.
whenTextContains(text)ConditionalFormatRuleBuilderUstawia regułę warunkową, która ma być aktywowana, gdy dane wejściowe zawierają określoną wartość.
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy dane wejściowe nie zawierają określonej wartości.
whenTextEndsWith(text)ConditionalFormatRuleBuilderUstawia regułę warunkową, która ma być aktywowana, gdy dane wejściowe kończą się określoną wartością.
whenTextEqualTo(text)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która ma się wyświetlić, gdy dane wejściowe są równe danej wartości.
whenTextStartsWith(text)ConditionalFormatRuleBuilderUstawia regułę warunkową, która uruchamia się, gdy dane wejściowe zaczynają się od określonej wartości.
withCriteria(criteria, args)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego na kryteria zdefiniowane przez wartości BooleanCriteria, zwykle pobierane z criteria i arguments istniejącej reguły.

Szczegółowa dokumentacja

build()

Tworzy regułę formatowania warunkowego z ustawień zastosowanych w konstruktorze.

Zwróć

ConditionalFormatRule – przedstawienie reguły formatu warunkowego,


copy()

Zwraca gotowe ustawienia konstruktora reguł z ustawieniami tej reguły.

Zwróć

ConditionalFormatRuleBuilder – kreator oparty na ustawieniach tej reguły


getBooleanCondition()

Pobiera informacje o zasadzie BooleanCondition, jeśli ta reguła używa kryteriów 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());
}

Zwróć

BooleanCondition – obiekt warunku typu wartość logiczna lub null, jeśli reguła nie korzysta z warunku logicznego.


getGradientCondition()

Pobiera informacje o regule GradientCondition, jeśli korzysta ona 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());
}

Zwróć

GradientCondition – obiekt warunku gradientu lub null, jeśli reguła nie korzysta z warunku gradientu.


getRanges()

Pobiera zakresy, do których stosowana jest ta reguła warunkowa.

// 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());
}

Zwróć

Range[] – zakresy, do których ma zastosowanie ta reguła warunkowa;


setBackground(color)

Ustawia kolor tła reguły formatowania warunkowego. Przekazywanie null powoduje usunięcie ustawienia formatu koloru tła z reguły.

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

NazwaTypOpis
colorStringWybierz kolor lub null, aby usunąć.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setBackgroundObject(color)

Ustawia kolor tła reguły formatowania warunkowego. Przekazywanie null powoduje usunięcie ustawienia formatu koloru tła z reguły.

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

NazwaTypOpis
colorColorŻądany obiekt koloru lub null do wyczyszczenia.

Zwróć

ConditionalFormatRuleBuilder – Kreator łańcuchów.


setBold(bold)

Ustawia pogrubienie tekstu w regule formatu warunkowego. Jeśli bold ma wartość true, reguła jest pogrubiona, gdy warunek jest spełniony. Jeśli false, po spełnieniu warunku zostanie ona usunięta. Jeśli przekazujesz null, pogrubienie jest usuwane 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

NazwaTypOpis
boldBooleanOkreśla, czy tekst ma zostać pogrubiony, jeśli jest spełniony warunek; null usuwa to ustawienie.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setFontColor(color)

Ustawia kolor czcionki w formacie reguły warunkowej. Jeśli przekazujesz null, ustawienie formatu czcionki jest usuwane z reguły.

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

NazwaTypOpis
colorStringWybierz kolor lub null, aby usunąć.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setFontColorObject(color)

Ustawia kolor czcionki w formacie reguły warunkowej. Jeśli przekazujesz null, ustawienie formatu czcionki jest usuwane z reguły.

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

NazwaTypOpis
colorColorŻądany obiekt koloru lub null do wyczyszczenia.

Zwróć

ConditionalFormatRuleBuilder – Kreator łańcuchów.


setGradientMaxpoint(color)

Czyści wartość maksymalnego punktu gradientu reguły warunkowej i zamiast niej używa wartości maksymalnej z zakresów reguły. Ustawia też kolor punktu 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

NazwaTypOpis
colorStringKolor maksymalnego punktu do ustawienia.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setGradientMaxpointObject(color)

Czyści wartość maksymalnego punktu gradientu reguły warunkowej i zamiast niej używa wartości maksymalnej z zakresów reguły. Ustawia też kolor punktu 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

NazwaTypOpis
colorColorObiekt koloru punktu maksymalnego do ustawienia.

Zwróć

ConditionalFormatRuleBuilder – Kreator łańcuchów.


setGradientMaxpointObjectWithValue(color, type, value)

Ustawia pola formatowania punktowego gradientu warunkowego formatu 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

NazwaTypOpis
colorColorKolor maksymalnego punktu do ustawienia.
typeInterpolationTypeMaks. typ interpolacji do ustawienia.
valueStringWartość maksymalnego, którą chcesz ustawić.

Zwróć

ConditionalFormatRuleBuilder – Kreator łańcuchów.


setGradientMaxpointWithValue(color, type, value)

Ustawia pola formatowania punktowego gradientu warunkowego formatu 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

NazwaTypOpis
colorStringKolor maksymalnego punktu do ustawienia.
typeInterpolationTypeMaks. typ interpolacji do ustawienia.
valueStringWartość maksymalnego, którą chcesz ustawić.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setGradientMidpointObjectWithValue(color, type, value)

Ustawia pole warunkowego reguły formatowania warunkowego. Usuwa wszystkie pola punktu środkowego, jeśli pole typu pośredniego ma wartość 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

NazwaTypOpis
colorColorKolor punktu środkowego do ustawienia.
typeInterpolationTypeTyp interpolacji do połowy lub ustaw null, aby usunąć.
valueStringWartość punktu środkowego, który ma zostać ustawiony.

Zwróć

ConditionalFormatRuleBuilder – Kreator łańcuchów.


setGradientMidpointWithValue(color, type, value)

Ustawia pole warunkowego reguły formatowania warunkowego. Usuwa wszystkie pola punktu środkowego, jeśli pole typu pośredniego ma wartość 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

NazwaTypOpis
colorStringKolor punktu środkowego do ustawienia.
typeInterpolationTypeTyp interpolacji do połowy lub ustaw null, aby usunąć.
valueStringWartość punktu środkowego, który ma zostać ustawiony.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setGradientMinpoint(color)

Czyści regułę wartości warunkowej reguły warunkowej i zamiast niej używa wartości minimalnej w zakresach reguł. Ustawia również kolor punktu 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

NazwaTypOpis
colorStringMinimalny kolor do ustawienia.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setGradientMinpointObject(color)

Czyści regułę wartości warunkowej reguły warunkowej i zamiast niej używa wartości minimalnej w zakresach reguł. Ustawia również kolor punktu 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

NazwaTypOpis
colorColorMin. kolor obiektu do ustawienia.

Zwróć

ConditionalFormatRuleBuilder – Kreator łańcuchów.


setGradientMinpointObjectWithValue(color, type, value)

Ustawia pole warunkowego reguły 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

NazwaTypOpis
colorColorMinimalny kolor do ustawienia.
typeInterpolationTypeMinimalny typ interpolacji do ustawienia.
valueStringWartość minimalna do ustawienia.

Zwróć

ConditionalFormatRuleBuilder – Kreator łańcuchów.


setGradientMinpointWithValue(color, type, value)

Ustawia pole warunkowego reguły 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

NazwaTypOpis
colorStringMinimalny kolor do ustawienia.
typeInterpolationTypeMinimalny typ interpolacji do ustawienia.
valueStringWartość minimalna do ustawienia.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setItalic(italic)

Ustawia kursywę tekstu w formacie reguły warunkowej. Jeśli warunek italic jest ustawiony na true, reguła spełnia kursywę, o ile warunek jest spełniony. Jeśli reguła jest spełniona, false usuwa kursywę. Jeśli przekazujesz null, ustawienie reguły kursywy jest usuwane 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

NazwaTypOpis
italicBooleanOkreśl, czy tekst ma być pisany kursywą, jeśli jest spełniony warunek. null usuwa to ustawienie.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setRanges(ranges)

Ustawia co najmniej 1 zakres, do którego ma zastosowanie ta reguła warunkowa. Ta operacja zastępuje wszystkie istniejące zakresy. Ustawienie pustej tablicy powoduje usunięcie wszystkich istniejących zakresów. Reguła musi mieć co najmniej 1 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

NazwaTypOpis
rangesRange[]Zakresy, do których stosowana jest ta reguła warunkowa.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setStrikethrough(strikethrough)

Ustawia przekreślenie tekstu w formacie reguły warunkowej. Jeśli strikethrough ma wartość true, reguła jest przekreślona, jeśli warunek jest spełniony. Jeśli false jest spełnione, reguła usuwa istniejące formatowanie z przekreśleniem. Jeśli przekazujesz null, ustawienie przekreślenia jest usuwane 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

NazwaTypOpis
strikethroughBooleanOkreśla, czy tekst ma być przekreślony, jeśli warunek formatowania jest spełniony. null usuwa to ustawienie.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


setUnderline(underline)

Ustawia podkreślenie tekstu w formacie reguły warunkowej. Jeśli underline ma wartość true, reguła podkreśla tekst, jeśli jest spełniony. W przypadku false reguła usuwa wszystkie podkreślenia, jeśli warunek jest spełniony. Jeśli przekazujesz null, ustawienie reguły podkreślania jest usuwane 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

NazwaTypOpis
underlineBooleanOkreśla, czy tekst ma zostać podkreślony, jeśli jest spełniony warunek. null usuwa to ustawienie.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenCellEmpty()

Ustawia regułę warunkową, która ma być 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);

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenCellNotEmpty()

Ustawia regułę formatowania warunkowego, 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);

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenDateAfter(date)

Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy data przypada po określonej 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

NazwaTypOpis
dateDateNajnowsza data.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenDateAfter(date)

Ustawia regułę warunkową, która uruchamia się, 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

NazwaTypOpis
dateRelativeDateNajnowsza data w stosunku do wybranego typu daty.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenDateBefore(date)

Ustawia regułę warunkową, która ma być 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

NazwaTypOpis
dateDateNajwcześniejsza dopuszczalna data.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenDateBefore(date)

Ustawia regułę warunkową, która uruchamia się, gdy data jest wcześniejsza od określonej daty 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 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

NazwaTypOpis
dateRelativeDateNajnowsza data w stosunku do wybranego typu daty.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenDateEqualTo(date)

Ustawia regułę warunkową, która uruchamia się, gdy data jest równa danej 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

NazwaTypOpis
dateDateJedyną dopuszczalną datę.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenDateEqualTo(date)

Ustawia regułę warunkową, która uruchamia się, gdy data jest równa 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 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

NazwaTypOpis
dateRelativeDateNajnowsza data w stosunku do wybranego typu daty.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenFormulaSatisfied(formula)

Ustawia regułę warunkową, która ma być aktywowana, gdy dana 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

NazwaTypOpis
formulaStringNiestandardowa formuła, która zwraca wartość true, jeśli dane wejściowe są prawidłowe.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberBetween(start, end)

Ustawia regułę formatu warunkowego, która będzie się uruchamiać, gdy liczba mieści się w zakresie lub między tymi wartościami.

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

NazwaTypOpis
startNumberNajniższa dopuszczalna wartość.
endNumberNajwyższa akceptowalna wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberEqualTo(number)

Ustawia regułę warunkową, która uruchamia się, gdy liczba jest równa danej 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

NazwaTypOpis
numberNumberJedyną dopuszczalną wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberGreaterThan(number)

Ustawia regułę warunkową, która uruchamia się, 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

NazwaTypOpis
numberNumberNajwyższa niedopuszczalna wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberGreaterThanOrEqualTo(number)

Ustawia regułę warunkową, która uruchamia się, gdy liczba jest większa od wartości podanej lub jej równa.

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

NazwaTypOpis
numberNumberNajniższa dopuszczalna wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberLessThan(number)

Ustawia regułę warunkową, która uruchamia się, gdy liczba jest mniejsza 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 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

NazwaTypOpis
numberNumberNajniższa niedopuszczalna wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberLessThanOrEqualTo(number)

Ustawia regułę formatu warunkowego, która będzie się uruchamiać, gdy liczba różni się od podanej wartości lub jej równa.

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

NazwaTypOpis
numberNumberNajwyższa akceptowalna wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberNotBetween(start, end)

Ustawia regułę warunkową, która uruchamia się, gdy liczba nie mieści się w zakresie i nie jest jedną z 2 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

NazwaTypOpis
startNumberNajniższa niedopuszczalna wartość.
endNumberNajwyższa niedopuszczalna wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenNumberNotEqualTo(number)

Ustawia regułę warunkową, która ma być aktywowana, gdy liczba różni 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 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

NazwaTypOpis
numberNumberJedyna niedopuszczalna wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenTextContains(text)

Ustawia regułę warunkową, która ma być 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

NazwaTypOpis
textStringWartość musi zawierać dane wejściowe.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenTextDoesNotContain(text)

Ustawia regułę warunkową, która uruchamia się, gdy dane wejściowe nie zawierają określonej 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 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

NazwaTypOpis
textStringWartość nie może zawierać danych wejściowych.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenTextEndsWith(text)

Ustawia regułę warunkową, która ma być 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

NazwaTypOpis
textStringTekst do porównania z końcem ciągu.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenTextEqualTo(text)

Ustawia regułę formatowania warunkowego, która ma się wyświetlić, gdy dane wejściowe są równe danej 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

NazwaTypOpis
textStringJedyną dopuszczalną wartość.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


whenTextStartsWith(text)

Ustawia regułę warunkową, która uruchamia się, 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

NazwaTypOpis
textStringTekst do porównania z początkiem ciągu znaków.

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów


withCriteria(criteria, args)

Ustawia regułę formatowania warunkowego na kryteria zdefiniowane przez wartości BooleanCriteria, zwykle pobierane z criteria i arguments istniejącej reguły.

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

NazwaTypOpis
criteriaBooleanCriteriaTyp kryteriów warunkowego.
argsObject[]Tablica argumentów odpowiednich dla typu kryterium. Liczba argumentów i ich typu są zgodne z odpowiednią metodą when...().

Zwróć

ConditionalFormatRuleBuilder – deweloper łańcuchów