Class ConditionalFormatRule

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[] - 应用此条件格式规则的范围。