Class ConditionalFormatRule

Правило условного форматирования

Access conditional formatting rules. To create a new rule, use Spreadsheet App.newConditionalFormatRule() and Conditional Format Rule Builder . You can use Sheet.setConditionalFormatRules(rules) to set the rules for a given sheet.

Методы

Метод Тип возвращаемого значения Краткое описание
copy() Conditional Format Rule Builder Возвращает построитель правил с предустановленными настройками данного правила.
get Boolean Condition() Boolean Condition |null Получает информацию Boolean Condition правила, если это правило использует логические критерии.
get Gradient Condition() Gradient Condition |null Получает информацию Gradient Condition для правила, если это правило использует критерии условий градиента.
get Ranges() Range[] Извлекает диапазоны, к которым применяется это правило условного форматирования.

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

copy()

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

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

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

get Boolean Condition()

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

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

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

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

get Gradient Condition()

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

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

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

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

get Ranges()

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

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

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

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