Class ConditionalFormatRuleBuilder

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 na podstawie ustawień zastosowanych do konstruktora.
copy()ConditionalFormatRuleBuilderZwraca gotowe konstruktor reguł z ustawieniami tej reguły.
getBooleanCondition()BooleanConditionPobiera informacje o regule BooleanCondition, jeśli ta reguła korzysta z: kryterium warunku logicznego.
getGradientCondition()GradientConditionPobiera 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)ConditionalFormatRuleBuilderUstawia kolor tła formatu reguły formatowania warunkowego.
setBackgroundObject(color)ConditionalFormatRuleBuilderUstawia kolor tła formatu reguły formatowania warunkowego.
setBold(bold)ConditionalFormatRuleBuilderUstawia pogrubienie tekstu w formacie reguły formatowania warunkowego.
setFontColor(color)ConditionalFormatRuleBuilderUstawia kolor czcionki formatu reguły formatowania warunkowego.
setFontColorObject(color)ConditionalFormatRuleBuilderUstawia kolor czcionki formatu reguły formatowania warunkowego.
setGradientMaxpoint(color)ConditionalFormatRuleBuilderUsuwa wartość maksymalnej liczby punktów gradientu reguły formatowania warunkowego, a zamiast tego używa maksymalnej wartości w zakresach reguły.
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderUsuwa 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)ConditionalFormatRuleBuilderUstawia pola gradientu maxpoint w regule formatowania warunkowego.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pola gradientu maxpoint w regule formatowania warunkowego.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pola gradientu punktu środkowego w regule formatowania warunkowego.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pola gradientu punktu środkowego w regule formatowania warunkowego.
setGradientMinpoint(color)ConditionalFormatRuleBuilderUsuwa wartość minimalną gradientu reguły formatowania warunkowego, a zamiast tego używa minimalnej wartości w zakresach reguły.
setGradientMinpointObject(color)ConditionalFormatRuleBuilderUsuwa wartość minimalną gradientu reguły formatowania warunkowego, a zamiast tego używa minimalnej wartości w zakresach reguły.
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pola gradientu w regule formatowania warunkowego.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderUstawia pola gradientu w regule formatowania warunkowego.
setItalic(italic)ConditionalFormatRuleBuilderUstawia kursywę tekstu w formacie reguły formatowania warunkowego.
setRanges(ranges)ConditionalFormatRuleBuilderUstawia co najmniej 1 zakres, do którego stosowana jest ta reguła formatowania warunkowego.
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderUstawia przekreślenie tekstu w formacie reguły formatowania warunkowego.
setUnderline(underline)ConditionalFormatRuleBuilderUstawia podkreślenie tekstu dla formatu reguły formatowania warunkowego.
whenCellEmpty()ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy komórka jest pusta.
whenCellNotEmpty()ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy komórka nie jest pusta.
whenDateAfter(date)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada po podanej wartości.
whenDateAfter(date)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada po określonej dacie względnej.
whenDateBefore(date)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada przed określoną datą.
whenDateBefore(date)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data przypada przed określoną datą względną.
whenDateEqualTo(date)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest równa podanej dacie.
whenDateEqualTo(date)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest równa podanej dacie względnej.
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy podana formuła zwróci wartość true.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderUstawia 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)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest równa podanej wartości.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest większa od podanej wartości.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest większa lub równa podanej .
whenNumberLessThan(number)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest mniejsza od podanej .
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba jest mniejsza lub równa podanej .
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego tak, aby była aktywowana, gdy liczba nie mieści się między dwóch określonych wartości.
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy liczba nie jest równa podanej wartości.
whenTextContains(text)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe zawierają określoną wartość.
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe nie zawierają danej .
whenTextEndsWith(text)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy dane wejściowe kończą się określoną wartością.
whenTextEqualTo(text)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, gdy wartość wejściowa jest równa podanej wartości.
whenTextStartsWith(text)ConditionalFormatRuleBuilderUstawia regułę formatowania warunkowego, która jest aktywowana, 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ą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

NazwaTypOpis
colorStringWybrany 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

NazwaTypOpis
colorColorŻą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

NazwaTypOpis
boldBooleanOkreś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

NazwaTypOpis
colorStringWybrany 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

NazwaTypOpis
colorColorŻą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

NazwaTypOpis
colorStringKolor 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

NazwaTypOpis
colorColorObiekt 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

NazwaTypOpis
colorColorKolor punktu maksymalnego do ustawienia.
typeInterpolationTypeTyp interpolacji maksymalnej do ustawienia.
valueStringMaksymalna 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

NazwaTypOpis
colorStringKolor punktu maksymalnego do ustawienia.
typeInterpolationTypeTyp interpolacji maksymalnej do ustawienia.
valueStringMaksymalna 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

NazwaTypOpis
colorColorKolor punktu środkowego do ustawienia.
typeInterpolationTypeTyp interpolacji punktu środkowego, który należy ustawić, lub null, aby usunąć.
valueStringWartość ś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

NazwaTypOpis
colorStringKolor punktu środkowego do ustawienia.
typeInterpolationTypeTyp interpolacji punktu środkowego, który należy ustawić, lub null, aby usunąć.
valueStringWartość ś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

NazwaTypOpis
colorStringKolor 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

NazwaTypOpis
colorColorObiekt 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

NazwaTypOpis
colorColorKolor punktu minimalnej do ustawienia.
typeInterpolationTypeTyp interpolacji punktu min. do ustawienia.
valueStringWartość 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

NazwaTypOpis
colorStringKolor punktu minimalnej do ustawienia.
typeInterpolationTypeTyp interpolacji punktu min. do ustawienia.
valueStringWartość 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

NazwaTypOpis
italicBooleanOkreś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

NazwaTypOpis
rangesRange[]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

NazwaTypOpis
strikethroughBooleanOkreś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

NazwaTypOpis
underlineBooleanOkreś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

NazwaTypOpis
dateDateNajnowsza 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

NazwaTypOpis
dateRelativeDateNajnowsza 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

NazwaTypOpis
dateDateNajwcześ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

NazwaTypOpis
dateRelativeDateNajnowsza 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

NazwaTypOpis
dateDateJedyna 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

NazwaTypOpis
dateRelativeDateNajnowsza 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

NazwaTypOpis
formulaStringFormuł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

NazwaTypOpis
startNumberNajniższa akceptowana wartość.
endNumberNajwyż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

NazwaTypOpis
numberNumberJedyna 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

NazwaTypOpis
numberNumberNajwyż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

NazwaTypOpis
numberNumberNajniż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

NazwaTypOpis
numberNumberNajniż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

NazwaTypOpis
numberNumberNajwyż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

NazwaTypOpis
startNumberNajniższa niedopuszczalna wartość.
endNumberNajwyż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

NazwaTypOpis
numberNumberJedyna 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

NazwaTypOpis
textStringWartość, 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

NazwaTypOpis
textStringWartość, 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

NazwaTypOpis
textStringTekst, 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

NazwaTypOpis
textStringJedyna 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

NazwaTypOpis
textStringTekst, 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

NazwaTypOpis
criteriaBooleanCriteriaTyp kryteriów formatowania warunkowego.
argsObject[]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