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