Class ConditionalFormatRuleBuilder

Конструктор правил условного форматирования

Конструктор правил условного форматирования.

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

Методы

Метод Тип возвращаемого значения Краткое описание
build() Conditional Format Rule Создает правило условного форматирования на основе настроек, примененных к конструктору.
copy() Conditional Format Rule Builder Возвращает построитель правил с предустановленными настройками данного правила.
get Boolean Condition() Boolean Condition |null Получает информацию Boolean Condition правила, если это правило использует логические критерии.
get Gradient Condition() Gradient Condition |null Получает информацию Gradient Condition для правила, если это правило использует критерии условий градиента.
get Ranges() Range[] Извлекает диапазоны, к которым применяется это правило условного форматирования.
set Background(color) Conditional Format Rule Builder Задает цвет фона для формата правила условного форматирования.
set Background Object(color) Conditional Format Rule Builder Задает цвет фона для формата правила условного форматирования.
set Bold(bold) Conditional Format Rule Builder Задает выделение текста жирным шрифтом для правила условного форматирования.
set Font Color(color) Conditional Format Rule Builder Задает цвет шрифта для формата правила условного форматирования.
set Font Color Object(color) Conditional Format Rule Builder Задает цвет шрифта для формата правила условного форматирования.
set Gradient Maxpoint(color) Conditional Format Rule Builder Сбрасывает значение параметра gradient maxpoint правила условного форматирования и вместо него использует максимальное значение в диапазонах правила.
set Gradient Maxpoint Object(color) Conditional Format Rule Builder Сбрасывает значение параметра gradient maxpoint правила условного форматирования и вместо него использует максимальное значение в диапазонах правила.
set Gradient Maxpoint Object With Value(color, type, value) Conditional Format Rule Builder Задает поля максимального значения градиента правила условного форматирования.
set Gradient Maxpoint With Value(color, type, value) Conditional Format Rule Builder Задает поля максимального значения градиента правила условного форматирования.
set Gradient Midpoint Object With Value(color, type, value) Conditional Format Rule Builder Задает поля для определения средней точки градиента в правиле условного форматирования.
set Gradient Midpoint With Value(color, type, value) Conditional Format Rule Builder Задает поля для определения средней точки градиента в правиле условного форматирования.
set Gradient Minpoint(color) Conditional Format Rule Builder Сбрасывает значение минимальной точки градиента правила условного форматирования и вместо этого использует минимальное значение в диапазонах правила.
set Gradient Minpoint Object(color) Conditional Format Rule Builder Сбрасывает значение минимальной точки градиента правила условного форматирования и вместо этого использует минимальное значение в диапазонах правила.
set Gradient Minpoint Object With Value(color, type, value) Conditional Format Rule Builder Задает поля минимальной точки градиента правила условного форматирования.
set Gradient Minpoint With Value(color, type, value) Conditional Format Rule Builder Задает поля минимальной точки градиента правила условного форматирования.
set Italic(italic) Conditional Format Rule Builder Задает курсивный шрифт для форматирования правила условного форматирования.
set Ranges(ranges) Conditional Format Rule Builder Задает один или несколько диапазонов, к которым применяется это правило условного форматирования.
set Strikethrough(strikethrough) Conditional Format Rule Builder Задает зачеркивание текста для форматирования правила условного форматирования.
set Underline(underline) Conditional Format Rule Builder Задает подчеркивание текста для правила условного форматирования.
when Cell Empty() Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда ячейка пуста.
when Cell Not Empty() Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда ячейка не пуста.
when Date After(date) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда дата находится после заданного значения.
when Date After(date) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда дата находится после указанной относительной даты.
when Date Before(date) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда дата предшествует заданной дате.
when Date Before(date) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда дата предшествует заданной относительной дате.
when Date Equal To(date) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда дата совпадает с заданной датой.
when Date Equal To(date) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда дата равна заданной относительной дате.
when Formula Satisfied(formula) Conditional Format Rule Builder Устанавливает правило условного форматирования, которое срабатывает, когда заданная формула принимает значение true .
when Number Between(start, end) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число находится между двумя указанными значениями или принимает одно из них.
when Number Equal To(number) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число равно заданному значению.
when Number Greater Than(number) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число превышает заданное значение.
when Number Greater Than Or Equal To(number) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число больше или равно заданному значению.
when Number Less Than(number) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число меньше заданного значения.
when Number Less Than Or Equal To(number) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число меньше или равно заданному значению.
when Number Not Between(start, end) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число не находится между двумя указанными значениями и не является ни одним из них.
when Number Not Equal To(number) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда число не равно заданному значению.
when Text Contains(text) Conditional Format Rule Builder Устанавливает правило условного форматирования, которое срабатывает, когда входные данные содержат заданное значение.
when Text Does Not Contain(text) Conditional Format Rule Builder Устанавливает правило условного форматирования, которое срабатывает, когда входные данные не содержат заданного значения.
when Text Ends With(text) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда ввод заканчивается заданным значением.
when Text Equal To(text) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда входные данные равны заданному значению.
when Text Starts With(text) Conditional Format Rule Builder Задает правило условного форматирования, которое срабатывает, когда ввод начинается с заданного значения.
with Criteria(criteria, args) Conditional Format Rule Builder Устанавливает правило условного форматирования в соответствии с критериями, определенными Boolean Criteria , обычно берущимися из criteria и arguments существующего правила.

Подробная документация

build()

Создает правило условного форматирования на основе настроек, примененных к конструктору.

Возвращаться

Conditional Format Rule — графическое представление правила условного форматирования.

copy()

Возвращает построитель правил с предустановленными настройками данного правила.

Возвращаться

Conditional Format Rule Builder — конструктор, основанный на настройках этого правила.

get Boolean Condition()

Получает информацию Boolean Condition правила, если это правило использует логические критерии. В противном случае возвращает 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());
}

Возвращаться

Boolean Condition |null — Объект логического условия или null , если правило не использует логическое условие.

get Gradient Condition()

Получает информацию Gradient Condition для правила, если это правило использует критерии условий градиента. В противном случае возвращает 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());
}

Возвращаться

Gradient Condition |null — Объект условия градиента или null , если правило не использует условие градиента.

get Ranges()

Извлекает диапазоны, к которым применяется это правило условного форматирования.

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

Возвращаться

Range[] — Диапазоны, к которым применяется это правило условного форматирования.

set Background(color)

Задает цвет фона для правила условного форматирования. Передача значения null удаляет настройку цвета фона правила.

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

Параметры

Имя Тип Описание
color String Желаемый цвет или null для очистки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Background Object(color)

Задает цвет фона для правила условного форматирования. Передача значения null удаляет настройку цвета фона правила.

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

Параметры

Имя Тип Описание
color Color Объект нужного цвета или null для очистки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Bold(bold)

Задает выделение текста жирным шрифтом для правила условного форматирования. Если bold равно true , правило выделяет текст жирным шрифтом, если условие выполняется; если false , правило удаляет любое существующее выделение жирным шрифтом, если условие выполняется. Передача значения null удаляет настройку форматирования жирным шрифтом из правила.

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

Параметры

Имя Тип Описание
bold Boolean Указывает, следует ли выделять текст жирным шрифтом при выполнении условия форматирования; null отменяет эту настройку.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Font Color(color)

Задает цвет шрифта для правила условного форматирования. Передача значения null удаляет настройку цвета шрифта из правила.

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

Параметры

Имя Тип Описание
color String Желаемый цвет или null для очистки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Font Color Object(color)

Задает цвет шрифта для правила условного форматирования. Передача значения null удаляет настройку цвета шрифта из правила.

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

Параметры

Имя Тип Описание
color Color Объект нужного цвета или null для очистки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Maxpoint(color)

Сбрасывает значение maxpoint градиента правила условного форматирования и вместо него использует максимальное значение в диапазонах правила. Также устанавливает цвет maxpoint градиента равным цвету входных данных. 

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

Параметры

Имя Тип Описание
color String Максимальное значение цвета для установки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Maxpoint Object(color)

Сбрасывает значение maxpoint градиента правила условного форматирования и вместо него использует максимальное значение в диапазонах правила. Также устанавливает цвет maxpoint градиента равным цвету входных данных. 

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

Параметры

Имя Тип Описание
color Color Объект максимального значения цвета, который необходимо установить.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Maxpoint Object With Value(color, type, value)

Задает поля максимального значения градиента правила условного форматирования. 

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

Параметры

Имя Тип Описание
color Color Максимальное значение цвета для установки.
type Interpolation Type Тип интерполяции по максимальному количеству точек для установки.
value String Максимальное значение, которое необходимо установить.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Maxpoint With Value(color, type, value)

Задает поля максимального значения градиента правила условного форматирования. 

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

Параметры

Имя Тип Описание
color String Максимальное значение цвета для установки.
type Interpolation Type Тип интерполяции по максимальному количеству точек для установки.
value String Максимальное значение, которое необходимо установить.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Midpoint Object With Value(color, type, value)

Задает поля середины градиента правила условного форматирования. Очищает все поля середины, если переданный тип интерполяции равен 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);

Параметры

Имя Тип Описание
color Color Цвет, определяющий среднюю точку.
type Interpolation Type Тип интерполяции по средней точке: установить значение или сбросить null .
value String Значение середины диапазона, которое необходимо установить.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Midpoint With Value(color, type, value)

Задает поля середины градиента правила условного форматирования. Очищает все поля середины, если переданный тип интерполяции равен 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);

Параметры

Имя Тип Описание
color String Цвет, определяющий среднюю точку.
type Interpolation Type Тип интерполяции по средней точке: установить значение или сбросить null .
value String Значение середины диапазона, которое необходимо установить.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Minpoint(color)

Сбрасывает значение минимальной точки градиента в правиле условного форматирования и вместо этого использует минимальное значение в диапазонах правила. Также устанавливает цвет минимальной точки градиента равным цвету входных данных. 

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

Параметры

Имя Тип Описание
color String Минимальный цвет для установки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Minpoint Object(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);

Параметры

Имя Тип Описание
color Color Минимальный цветовой объект для установки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Minpoint Object With Value(color, type, value)

Задает поля минимальной точки градиента правила условного форматирования. 

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

Параметры

Имя Тип Описание
color Color Минимальный цвет для установки.
type Interpolation Type Тип интерполяции по минимальной точке, который необходимо установить.
value String Минимальное значение, которое необходимо установить.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Gradient Minpoint With Value(color, type, value)

Задает поля минимальной точки градиента правила условного форматирования. 

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

Параметры

Имя Тип Описание
color String Минимальный цвет для установки.
type Interpolation Type Тип интерполяции по минимальной точке, который необходимо установить.
value String Минимальное значение, которое необходимо установить.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Italic(italic)

Задает курсив для текста в правиле условного форматирования. Если italic равно true , правило выделяет текст курсивом, если условие выполняется; если false , правило удаляет существующий курсив, если условие выполняется. Передача значения null удаляет настройку курсива из правила. 

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

Параметры

Имя Тип Описание
italic Boolean Указывает, следует ли выделять текст курсивом при выполнении условия форматирования; null отменяет эту настройку.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Ranges(ranges)

Задает один или несколько диапазонов, к которым применяется это правило условного форматирования. Эта операция заменяет все существующие диапазоны. Установка пустого массива очищает все существующие диапазоны. Правило должно содержать как минимум один диапазон. 

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

Параметры

Имя Тип Описание
ranges Range[] Диапазоны, к которым применяется это правило условного форматирования.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Strikethrough(strikethrough)

Задает зачеркивание текста для правила условного форматирования. Если strikethrough равно true , правило зачеркивает текст, если условие выполняется; если false , правило удаляет любое существующее зачеркивание, если условие выполняется. Передача значения null удаляет настройку форматирования зачеркивания из правила. 

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

Параметры

Имя Тип Описание
strikethrough Boolean Указывает, следует ли зачеркивать текст при выполнении условия форматирования; null отменяет эту настройку.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

set Underline(underline)

Задает подчеркивание текста для правила условного форматирования. Если underline равно true , правило подчеркивает текст, если условие выполняется; если false , правило удаляет любое существующее подчеркивание, если условие выполняется. Передача значения null удаляет настройку формата подчеркивания из правила. 

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

Параметры

Имя Тип Описание
underline Boolean Подчеркивать ли текст при выполнении условия форматирования; null отменяет эту настройку.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Cell Empty()

Задает правило условного форматирования, которое срабатывает, когда ячейка пуста. 

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

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Cell Not Empty()

Задает правило условного форматирования, которое срабатывает, когда ячейка не пуста. 

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

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Date After(date)

Задает правило условного форматирования, которое срабатывает, когда дата находится после заданного значения. 

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

Параметры

Имя Тип Описание
date Date Последняя дата.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Date After(date)

Задает правило условного форматирования, которое срабатывает, когда дата находится после указанной относительной даты. 

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

Параметры

Имя Тип Описание
date Relative Date Последняя дата относительно выбранного типа даты.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Date Before(date)

Задает правило условного форматирования, которое срабатывает, когда дата предшествует заданной дате. 

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

Параметры

Имя Тип Описание
date Date Самая ранняя неприемлемая дата.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Date Before(date)

Задает правило условного форматирования, которое срабатывает, когда дата предшествует заданной относительной дате. 

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

Параметры

Имя Тип Описание
date Relative Date Последняя дата относительно выбранного типа даты.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Date Equal To(date)

Задает правило условного форматирования, которое срабатывает, когда дата равна заданной дате. 

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

Параметры

Имя Тип Описание
date Date Единственная допустимая дата.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Date Equal To(date)

Задает правило условного форматирования, которое срабатывает, когда дата равна заданной относительной дате. 

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

Параметры

Имя Тип Описание
date Relative Date Последняя дата относительно выбранного типа даты.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Formula Satisfied(formula)

Устанавливает правило условного форматирования, которое срабатывает, когда заданная формула принимает значение 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);

Параметры

Имя Тип Описание
formula String Пользовательская формула, которая возвращает true , если входные данные допустимы.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Between(start, end)

Задает правило условного форматирования, которое срабатывает, когда число находится между двумя указанными значениями или принимает одно из них. 

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

Параметры

Имя Тип Описание
start Number Наименьшее допустимое значение.
end Number Максимально допустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Equal To(number)

Задает правило условного форматирования, которое срабатывает, когда число равно заданному значению. 

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

Параметры

Имя Тип Описание
number Number Единственное допустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Greater Than(number)

Задает правило условного форматирования, которое срабатывает, когда число превышает заданное значение. 

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

Параметры

Имя Тип Описание
number Number Наивысшее недопустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Greater Than Or Equal To(number)

Задает правило условного форматирования, которое срабатывает, когда число больше или равно заданному значению. 

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

Параметры

Имя Тип Описание
number Number Наименьшее допустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Less Than(number)

Задает правило условного форматирования, которое срабатывает, когда число меньше заданного значения. 

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

Параметры

Имя Тип Описание
number Number Наименьшее недопустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Less Than Or Equal To(number)

Задает правило условного форматирования, которое срабатывает, когда число меньше или равно заданному значению. 

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

Параметры

Имя Тип Описание
number Number Максимально допустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Not Between(start, end)

Задает правило условного форматирования, которое срабатывает, когда число не находится между двумя указанными значениями и не является ни одним из них. 

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

Параметры

Имя Тип Описание
start Number Наименьшее недопустимое значение.
end Number Наивысшее недопустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Number Not Equal To(number)

Задает правило условного форматирования, которое срабатывает, когда число не равно заданному значению. 

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

Параметры

Имя Тип Описание
number Number Единственное неприемлемое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Text Contains(text)

Устанавливает правило условного форматирования, которое срабатывает, когда входные данные содержат заданное значение. 

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

Параметры

Имя Тип Описание
text String Значение, которое должен содержать ввод.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Text Does Not Contain(text)

Устанавливает правило условного форматирования, которое срабатывает, когда входные данные не содержат заданного значения. 

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

Параметры

Имя Тип Описание
text String Значение, которое входные данные не должны содержать.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Text Ends With(text)

Задает правило условного форматирования, которое срабатывает, когда ввод заканчивается заданным значением. 

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

Параметры

Имя Тип Описание
text String Текст для сравнения с концом строки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Text Equal To(text)

Задает правило условного форматирования, которое срабатывает, когда входные данные равны заданному значению. 

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

Параметры

Имя Тип Описание
text String Единственное допустимое значение.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

when Text Starts With(text)

Задает правило условного форматирования, которое срабатывает, когда ввод начинается с заданного значения. 

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

Параметры

Имя Тип Описание
text String Текст для сравнения с началом строки.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.

with Criteria(criteria, args)

Устанавливает правило условного форматирования в соответствии с критериями, определенными Boolean Criteria , обычно берущимися из criteria и arguments существующего правила. 

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

Параметры

Имя Тип Описание
criteria Boolean Criteria Тип критериев условного форматирования.
args Object[] Массив аргументов, соответствующих типу критерия; количество аргументов и их тип соответствуют соответствующему методу when...() описанному выше.

Возвращаться

Conditional Format Rule Builder — инструмент для создания цепочек правил.