访问条件格式规则。如需创建新规则,请使用 SpreadsheetApp.newConditionalFormatRule()
和 ConditionalFormatRuleBuilder
。您可以使用 Sheet.setConditionalFormatRules(rules)
为给定工作表设置规则。
方法
方法 | 返回类型 | 简介 |
---|---|---|
copy() | ConditionalFormatRuleBuilder | 返回采用此规则设置的规则生成器预设。 |
getBooleanCondition() | BooleanCondition | 如果此规则使用布尔值条件条件,则检索规则的 BooleanCondition 信息。 |
getGradientCondition() | GradientCondition | 如果此规则使用梯度条件,则检索规则的 GradientCondition 信息。 |
getRanges() | Range[] | 检索要应用此条件格式规则的范围。 |
详细文档
copy()
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[]
- 应用此条件格式规则的范围。