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[] — диапазоны, к которым применяется это правило условного форматирования.