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