Ta strona została przetłumaczona przez Cloud Translation API.

Class 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Metody

Metoda	Zwracany typ	Krótki opis
`build()`	`ConditionalFormatRule`	Tworzy regułę formatowania warunkowego na podstawie ustawień zastosowanych w kreatorze.
`copy()`	`ConditionalFormatRuleBuilder`	Zwraca gotowy szablon kreatora reguł z ustawieniami tej reguły.
`getBooleanCondition()`	`BooleanCondition`	Pobiera informacje `BooleanCondition` reguły, jeśli zawiera ona warunki logiczne.
`getGradientCondition()`	`GradientCondition`	Pobiera informacje `GradientCondition` reguły, jeśli używa ona kryteriów warunków gradientowych.
`getRanges()`	`Range[]`	Pobiera zakresy, do których ma zastosowanie ta reguła formatowania warunkowego.
`setBackground(color)`	`ConditionalFormatRuleBuilder`	Ustawia kolor tła formatu reguły formatowania warunkowego.
`setBackgroundObject(color)`	`ConditionalFormatRuleBuilder`	Ustawia kolor tła formatu reguły formatowania warunkowego.
`setBold(bold)`	`ConditionalFormatRuleBuilder`	Ustawia pogrubienie tekstu dla formatu reguły formatowania warunkowego.
`setFontColor(color)`	`ConditionalFormatRuleBuilder`	Ustawia kolor czcionki dla formatu reguły formatowania warunkowego.
`setFontColorObject(color)`	`ConditionalFormatRuleBuilder`	Ustawia kolor czcionki dla formatu reguły formatowania warunkowego.
`setGradientMaxpoint(color)`	`ConditionalFormatRuleBuilder`	Usuwa wartość punktu maksymalnego gradientu reguły formatowania warunkowego i zamiast niej używa maksymalnej wartości w zakresach reguły.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	Usuwa wartość punktu maksymalnego gradientu reguły formatowania warunkowego i zamiast niej używa maksymalnej wartości w zakresach reguły.
`setGradientMaxpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Ustawia pola gradientu punktu maksymalnego reguły formatowania warunkowego.
`setGradientMaxpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Ustawia pola gradientu punktu maksymalnego reguły formatowania warunkowego.
`setGradientMidpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Ustawia pola środkowej wartości gradientu reguły formatowania warunkowego.
`setGradientMidpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Ustawia pola środkowej wartości gradientu reguły formatowania warunkowego.
`setGradientMinpoint(color)`	`ConditionalFormatRuleBuilder`	Usuwa wartość punktu minimalnego gradientu reguły formatowania warunkowego i zamiast niej używa minimalnej wartości w zakresach reguły.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	Usuwa wartość punktu minimalnego gradientu reguły formatowania warunkowego i zamiast niej używa minimalnej wartości w zakresach reguły.
`setGradientMinpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Ustawia pola minimalnego punktu gradientu reguły formatowania warunkowego.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Ustawia pola minimalnego punktu gradientu reguły formatowania warunkowego.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	Ustawia kursywę tekstu w formatowaniu reguły formatowania warunkowego.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	Określa co najmniej 1 zakres, do którego ma być stosowana ta reguła formatowania warunkowego.
`setStrikethrough(strikethrough)`	`ConditionalFormatRuleBuilder`	Ustawia przekreślenie tekstu dla formatu reguły formatowania warunkowego.
`setUnderline(underline)`	`ConditionalFormatRuleBuilder`	Ustawia podkreślenie tekstu dla formatu reguły formatowania warunkowego.
`whenCellEmpty()`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być uruchamiana, gdy komórka jest pusta.
`whenCellNotEmpty()`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby była aktywna, gdy komórka nie jest pusta.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest późniejsza niż podana wartość.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby działała, gdy data jest późniejsza niż podana data względna.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby działała, gdy data jest wcześniejsza od podanej daty.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby działała, gdy data jest wcześniejsza od podanej daty względnej.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być uruchamiana, gdy data jest równa podanej dacie.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, aby działała, gdy data jest równa podanej dacie względnej.
`whenFormulaSatisfied(formula)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby działała, gdy dana formuła zwróci wartość `true`.
`whenNumberBetween(start, end)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy liczba mieści się między 2 określonymi wartościami lub jest jedną z tych wartości.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy liczba jest równa podanej wartości.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy liczba jest większa od podanej wartości.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby była ona aktywna, gdy liczba jest większa lub równa podanej wartości.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego tak, aby była aktywna, gdy liczba jest mniejsza od podanej wartości.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, aby działała, gdy liczba jest mniejsza lub równa podanej wartości.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	Ta reguła formatowania warunkowego jest uruchamiana, gdy liczba nie mieści się między 2 określonymi wartościami ani nie jest równa żadnej z nich.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy liczba nie jest równa podanej wartości.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy dane wejściowe zawierają określoną wartość.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być uruchamiana, gdy dane wejściowe nie zawierają określonej wartości.
`whenTextEndsWith(text)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy dane wejściowe kończą się daną wartością.
`whenTextEqualTo(text)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy dane wejściowe są równe podanej wartości.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy dane wejściowe zaczynają się od określonej wartości.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	Ustawia regułę formatowania warunkowego na kryteria zdefiniowane przez wartości `BooleanCriteria`, które są zwykle pobierane z `criteria` i `arguments` istniejącej reguły.

Szczegółowa dokumentacja

`build()`

Tworzy regułę formatowania warunkowego na podstawie ustawień zastosowanych w kreatorze.

Powrót

ConditionalFormatRule – reprezentacja reguły formatowania warunkowego

`copy()`

Zwraca gotowy szablon kreatora reguł z ustawieniami tej reguły.

Powrót

ConditionalFormatRuleBuilder – kreator na podstawie ustawień tej reguły.

`getBooleanCondition()`

Pobiera informacje BooleanCondition reguły, jeśli zawiera ona warunki logiczne. W przeciwnym razie zwraca wartość null.

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Powrót

BooleanCondition – obiekt warunku logicznego lub null, jeśli reguła nie używa warunku logicznego.

`getGradientCondition()`

Pobiera informacje GradientCondition reguły, jeśli używa ona kryteriów warunków gradientowych. W przeciwnym razie zwraca wartość null.

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const 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 warunku gradientu.

`getRanges()`

Pobiera zakresy, do których ma zastosowanie ta reguła formatowania warunkowego.

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Powrót

Range[] – zakresy, do których jest stosowana ta reguła formatowania warunkowego.

`setBackground(color)`

Ustawia kolor tła formatu reguły formatowania warunkowego. Podanie wartości nullpowoduje usunięcie z reguły ustawienia 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".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`String`	Wybrany kolor lub `null`, aby go wyczyścić.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setBackgroundObject(color)`

Ustawia kolor tła formatu reguły formatowania warunkowego. Podanie wartości nullpowoduje usunięcie z reguły ustawienia 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".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Obiekt z wybranym kolorem lub `null`, aby go wyczyścić.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania.

`setBold(bold)`

Ustawia pogrubienie tekstu dla formatu reguły formatowania warunkowego. Jeśli bold ma wartość true, reguła po spełnieniu warunku pogrubia tekst. Jeśli false ma wartość true, reguła usuwa wszelkie pogrubienia po spełnieniu warunku. Podanie wartości null spowoduje usunięcie z reguły ustawienia formatu pogrubionego.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBold(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`bold`	`Boolean`	Określa, czy tekst ma być pogrubiony, jeśli warunek formatu jest spełniony. `null` usuwa to ustawienie.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setFontColor(color)`

Ustawia kolor czcionki dla formatu reguły formatowania warunkowego. Przekazanie wartości null powoduje usunięcie z reguły ustawienia formatu koloru czcionki.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`String`	Wybrany kolor lub `null`, aby go wyczyścić.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setFontColorObject(color)`

Ustawia kolor czcionki dla formatu reguły formatowania warunkowego. Przekazanie wartości null powoduje usunięcie z reguły ustawienia formatu koloru czcionki.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Obiekt z wybranym kolorem lub `null`, aby go wyczyścić.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania.

`setGradientMaxpoint(color)`

Usuwa wartość punktu maksymalnego gradientu reguły formatowania warunkowego i zamiast niej używa maksymalnej wartości w zakresach reguły. Ustawia też kolor punktu maksymalnego 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor punktu maksymalnego do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setGradientMaxpointObject(color)`

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Obiekt koloru punktu maksymalnego do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania.

`setGradientMaxpointObjectWithValue(color, type, value)`

Ustawia pola gradientu punktu maksymalnego 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, accent 2 to accent
// 3 colors, based on their values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Kolor punktu maksymalnego do ustawienia.
`type`	`InterpolationType`	Typ interpolacji punktu maksymalnego do ustawienia.
`value`	`String`	Wartość maksymalna do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania.

`setGradientMaxpointWithValue(color, type, value)`

Ustawia pola gradientu punktu maksymalnego 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 green to blue, based on their
// values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor punktu maksymalnego do ustawienia.
`type`	`InterpolationType`	Typ interpolacji punktu maksymalnego do ustawienia.
`value`	`String`	Wartość maksymalna do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setGradientMidpointObjectWithValue(color, type, value)`

Ustawia pola środkowej wartości gradientu reguły formatowania warunkowego. Czyści 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Kolor punktu środkowego do ustawienia.
`type`	`InterpolationType`	Typ interpolacji punktu środkowego do ustawienia lub `null` do wyczyszczenia.
`value`	`String`	Wartość punktu środkowego do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania.

`setGradientMidpointWithValue(color, type, value)`

Ustawia pola środkowej wartości gradientu reguły formatowania warunkowego. Czyści 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor punktu środkowego do ustawienia.
`type`	`InterpolationType`	Typ interpolacji punktu środkowego do ustawienia lub `null` do wyczyszczenia.
`value`	`String`	Wartość punktu środkowego do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setGradientMinpoint(color)`

Usuwa wartość punktu minimalnego gradientu reguły formatowania warunkowego i zamiast niej używa minimalnej wartości w zakresach reguły. Ustawia też kolor punktu minimalnego 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor minimalnej wartości do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setGradientMinpointObject(color)`

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Obiekt koloru punktu minimalnego do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania.

`setGradientMinpointObjectWithValue(color, type, value)`

Ustawia pola minimalnego punktu gradientu 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Kolor minimalnej wartości do ustawienia.
`type`	`InterpolationType`	Typ interpolacji minimalnego punktu docelowego do ustawienia.
`value`	`String`	Wartość minimalna do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania.

`setGradientMinpointWithValue(color, type, value)`

Ustawia pola minimalnego punktu gradientu 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kolor minimalnej wartości do ustawienia.
`type`	`InterpolationType`	Typ interpolacji minimalnego punktu docelowego do ustawienia.
`value`	`String`	Wartość minimalna do ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setItalic(italic)`

Ustawia kursywę tekstu w formatowaniu reguły formatowania warunkowego. Jeśli italic ma wartość true, reguła po spełnieniu warunku pogrubia tekst. Jeśli ma wartość false, reguła usuwa dotychczasowe pogrubienie po spełnieniu warunku. Przekazanie wartości null powoduje usunięcie z reguły ustawienia formatu kursywy.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setItalic(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`italic`	`Boolean`	Określa, czy tekst ma być pochylony, jeśli warunek formatu jest spełniony. `null` usuwanie tego ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setRanges(ranges)`

Określa co najmniej 1 zakres, do którego ma być stosowana ta reguła formatowania warunkowego. Ta operacja zastępuje wszystkie istniejące zakresy. Ustawienie pustego tablicę powoduje wyczyszczenie 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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeOne = sheet.getRange('A1:B3');
const rangeTwo = sheet.getRange('D4:F6');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([rangeOne, rangeTwo])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`ranges`	`Range[]`	Zakresy, do których ma zastosowanie ta reguła formatowania warunkowego.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setStrikethrough(strikethrough)`

Ustawia przekreślenie tekstu dla formatu reguły formatowania warunkowego. Jeśli strikethrough to true, reguła przekreśla tekst, jeśli warunek jest spełniony. Jeśli false, reguła usuwa wszelkie istniejące formatowanie przekreślenia, jeśli warunek jest spełniony. Podanie wartości null powoduje usunięcie z reguły ustawienia formatu przekreślenia.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setStrikethrough(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`strikethrough`	`Boolean`	Określa, czy tekst ma być przekreślony, jeśli warunek formatu jest spełniony. `null` usuwa to ustawienie.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`setUnderline(underline)`

Ustawia podkreślenie tekstu dla formatu reguły formatowania warunkowego. Jeśli underline ma wartość true, reguła podkreśla tekst, gdy warunek jest spełniony. Jeśli ma wartość false, reguła usuwa wszystkie istniejące podkreślenia, gdy warunek jest spełniony. Podanie wartości null powoduje usunięcie z reguły ustawienia formatu podkreślenia.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setUnderline(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`underline`	`Boolean`	Określa, czy tekst ma być podkreślony, gdy warunek formatowania jest spełniony.`null` usuwanie tego ustawienia.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenCellEmpty()`

Ustawia regułę formatowania warunkowego, która ma być uruchamiana, 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenCellNotEmpty()`

Ustawia regułę formatowania warunkowego tak, aby była aktywna, 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellNotEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenDateAfter(date)`

Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy data jest późniejsza niż podana wartość.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`date`	`Date`	Najnowsza data.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenDateAfter(date)`

Ustawia regułę formatowania warunkowego tak, aby działała, gdy data jest późniejsza niż podana data względna.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`date`	`RelativeDate`	Najnowsza data w przypadku wybranego typu daty.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenDateBefore(date)`

Ustawia regułę formatowania warunkowego tak, aby działała, gdy data jest wcześniejsza od podanej daty.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`date`	`Date`	Najwcześniejsza niedopuszczalna data.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenDateBefore(date)`

Ustawia regułę formatowania warunkowego tak, aby działała, gdy data jest wcześniejsza od podanej 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`date`	`RelativeDate`	Najnowsza data w przypadku wybranego typu daty.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenDateEqualTo(date)`

Ustawia regułę formatowania warunkowego, która ma być uruchamiana, 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`date`	`Date`	Jedyna dopuszczalna data.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenDateEqualTo(date)`

Ustawia regułę formatowania warunkowego, aby działała, 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`date`	`RelativeDate`	Najnowsza data w przypadku wybranego typu daty.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenFormulaSatisfied(formula)`

Ustawia regułę formatowania warunkowego tak, aby działała, 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)".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenFormulaSatisfied('=EQ(B4, C3)')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`formula`	`String`	Formuła niestandardowa, która zwraca wartość `true`, jeśli dane wejściowe są prawidłowe.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberBetween(start, end)`

Ustawia regułę formatowania warunkowego tak, aby była aktywowana, gdy liczba mieści się między 2 określonymi wartościami lub jest jedną z tych 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`start`	`Number`	Najniższa dopuszczalna wartość.
`end`	`Number`	Najwyższa dopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberEqualTo(number)`

Ustawia regułę formatowania warunkowego tak, aby była 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Jedyna dopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberGreaterThan(number)`

Ustawia regułę formatowania warunkowego, która ma być 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najwyższa niedopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberGreaterThanOrEqualTo(number)`

Ustawia regułę formatowania warunkowego tak, aby była ona aktywna, gdy liczba jest większa lub 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 a number greater than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najniższa dopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberLessThan(number)`

Ustawia regułę formatowania warunkowego tak, aby była aktywna, 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najniższa niedopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberLessThanOrEqualTo(number)`

Ustawia regułę formatowania warunkowego, aby działała, gdy liczba jest mniejsza lub 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 a number less than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Najwyższa dopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberNotBetween(start, end)`

Ta reguła formatowania warunkowego jest uruchamiana, gdy liczba nie mieści się między 2 określonymi wartościami ani nie jest równa żadnej z nich.

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`start`	`Number`	Najniższa niedopuszczalna wartość.
`end`	`Number`	Najwyższa niedopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenNumberNotEqualTo(number)`

Ustawia regułę formatowania warunkowego, która ma być 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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`number`	`Number`	Jedyna niedopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenTextContains(text)`

Ustawia regułę formatowania warunkowego, 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".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextContains('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`text`	`String`	Wartość, którą musi zawierać dane wejściowe.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenTextDoesNotContain(text)`

Ustawia regułę formatowania warunkowego, która ma być uruchamiana, 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".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextDoesNotContain('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`text`	`String`	Wartość, której nie może zawierać dane wejściowe.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenTextEndsWith(text)`

Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy dane wejściowe kończą się daną 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".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEndsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst do porównania z końcem ciągu znaków.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenTextEqualTo(text)`

Ustawia regułę formatowania warunkowego, która ma być aktywowana, gdy dane wejściowe są równe 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".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`text`	`String`	Jedyna dopuszczalna wartość.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`whenTextStartsWith(text)`

Ustawia regułę formatowania warunkowego, która ma być 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".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextStartsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`text`	`String`	Tekst do porównania z początkiem ciągu.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania

`withCriteria(criteria, args)`

Ustawia regułę formatowania warunkowego na kryteria zdefiniowane przez wartości BooleanCriteria, które są 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.

const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
const booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  const rule = SpreadsheetApp.newConditionalFormatRule()
                   .withCriteria(
                       booleanCondition.getCriteriaType(),
                       booleanCondition.getCriteriaValues(),
                       )
                   .setBackground('#000000')
                   .setRanges(rules[0].getRanges())
                   .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`criteria`	`BooleanCriteria`	Typ kryteriów formatowania warunkowego.
`args`	`Object[]`	tablica argumentów odpowiednich dla typu kryteriów; liczba argumentów i ich typ odpowiadają odpowiadającej metodzie `when...()` podanej powyżej.

Powrót

ConditionalFormatRuleBuilder – kreator do łańcuchowania