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

Class ConditionalFormatRule

Доступ к правилам условного форматирования. Чтобы создать новое правило, используйте SpreadsheetApp.newConditionalFormatRule() и ConditionalFormatRuleBuilder . Вы можете использовать Sheet.setConditionalFormatRules(rules) для установки правил для данного листа.

Методы

Метод	Тип возврата	Краткое описание
`copy()`	`ConditionalFormatRuleBuilder`	Возвращает набор настроек построителя правил с настройками этого правила.
`getBooleanCondition()`	`BooleanCondition`	Извлекает информацию `BooleanCondition` правила, если это правило использует логические критерии условия.
`getGradientCondition()`	`GradientCondition`	Извлекает информацию `GradientCondition` правила, если это правило использует критерии условия градиента.
`getRanges()`	`Range[]`	Извлекает диапазоны, к которым применяется это правило условного форматирования.

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

`copy()`

Возвращает набор настроек построителя правил с настройками этого правила.

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

ConditionalFormatRuleBuilder — конструктор на основе настроек этого правила.

`getBooleanCondition()`

Извлекает информацию BooleanCondition правила, если это правило использует логические критерии условия. В противном случае возвращает null .

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

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

BooleanCondition — объект логического условия или null если правило не использует логическое условие.

`getGradientCondition()`

Извлекает информацию GradientCondition правила, если это правило использует критерии условия градиента. В противном случае возвращает null .

// Log the gradient minimum color of the first conditional format rule of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

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

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

`getRanges()`

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

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

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

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