Конструктор правил условного форматирования.
// 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 | Задает поля минимальной точки градиента правила условного форматирования. |
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 , если правило не использует булево условие.
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)
Задаёт цвет фона для формата правила условного форматирования. Передача значения 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)
Очищает значение максимальной точки градиента правила условного форматирования и вместо него использует максимальное значение в диапазонах правила. Также устанавливает цвет максимальной точки градиента равным входному цвету.
// 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)
Очищает значение максимальной точки градиента правила условного форматирования и вместо него использует максимальное значение в диапазонах правила. Также устанавливает цвет максимальной точки градиента равным входному цвету.
// 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 — конструктор для создания цепочек.