Эта страница переведена с помощью Cloud Translation API.

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`	Извлекает информацию `Boolean Condition` правила, если это правило использует логические критерии условия.
`get Gradient Condition()`	`Gradient Condition`	Извлекает информацию `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`	Очищает значение максимальной точки градиента правила условного формата и вместо этого использует максимальное значение в диапазонах правила.
`set Gradient Maxpoint Object(color)`	`Conditional Format Rule Builder`	Очищает значение максимальной точки градиента правила условного формата и вместо этого использует максимальное значение в диапазонах правила.
`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`	Устанавливает поля minpoint градиента правила условного формата.
`set Gradient Minpoint With Value(color, type, value)`	`Conditional Format Rule Builder`	Устанавливает поля minpoint градиента правила условного формата.
`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 , если правило не использует логическое условие.

`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 , если правило не использует условие градиента.

`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)`

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

// 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 градиента в качестве входного цвета.

// 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`	Цвет maxpoint, который нужно установить.

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

Conditional Format Rule Builder — построитель для связывания

`set Gradient Maxpoint 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`	Объект цвета maxpoint, который необходимо установить.

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

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`	Цвет maxpoint, который нужно установить.
`type`	`Interpolation Type`	Устанавливаемый тип интерполяции maxpoint.
`value`	`String`	Значение maxpoint, которое необходимо установить.

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

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`	Цвет maxpoint, который нужно установить.
`type`	`Interpolation Type`	Устанавливаемый тип интерполяции maxpoint.
`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)`

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

Очищает значение минимальной точки градиента правила условного формата и вместо этого использует минимальное значение в диапазонах правила. Также устанавливает цвет minpoint градиента в качестве входного цвета.

// 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`	Цвет minpoint, который нужно установить.

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

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`	Объект цвета minpoint, который необходимо установить.

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

Conditional Format Rule Builder — построитель для объединения в цепочки.

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

Устанавливает поля minpoint градиента правила условного формата.

// 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`	Цвет minpoint, который нужно установить.
`type`	`Interpolation Type`	Устанавливаемый тип интерполяции minpoint.
`value`	`String`	Значение minpoint, которое необходимо установить.

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

Conditional Format Rule Builder — построитель для объединения в цепочки.

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

Устанавливает поля minpoint градиента правила условного формата.

// 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`	Цвет minpoint, который нужно установить.
`type`	`Interpolation Type`	Устанавливаемый тип интерполяции minpoint.
`value`	`String`	Значение minpoint, которое необходимо установить.

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

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 — построитель для связывания