访问 ConditionalFormatRules
中的布尔值条件。每个条件格式规则都可以包含一个布尔条件。布尔值条件本身包含一个布尔值条件(包含值)和格式设置。系统会根据单元格的内容评估条件,得出 true
或 false
值。如果条件的计算结果为 true
,则条件的格式设置会应用于单元格。
方法
方法 | 返回类型 | 简介 |
---|---|---|
getBackgroundObject() | Color | 获取此布尔值条件的背景颜色。 |
getBold() | Boolean | 如果此布尔条件将文本加粗,则返回 true ;如果此布尔条件从文本中移除粗体,则返回 false 。 |
getCriteriaType() | BooleanCriteria | 获取 BooleanCriteria 枚举中定义的规则的条件类型。 |
getCriteriaValues() | Object[] | 获取规则条件的参数数组。 |
getFontColorObject() | Color | 获取此布尔值条件的字体颜色。 |
getItalic() | Boolean | 如果此布尔条件将文本设为斜体,则返回 true ;如果此布尔条件移除文本的斜体,则返回 false 。 |
getStrikethrough() | Boolean | 如果此布尔条件删除文本,则返回 true ;如果此布尔条件从文本中移除删除线,则返回 false 。 |
getUnderline() | Boolean | 如果此布尔条件为文本添加下划线,则返回 true ;如果此布尔条件移除文本的下划线,则返回 false 。 |
详细文档
getBackgroundObject()
获取此布尔值条件的背景颜色。如果未设置,则返回 null
。
// Logs the boolean condition background color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getBackgroundObject(); Logger.log("The background color for rule %s is %s", i, color.asRgbColor().asHexString()); }
弃踢回攻
Color
- 背景颜色,如果未针对此条件设置,则为 null
。
getBold()
如果此布尔条件将文本加粗,则返回 true
;如果此布尔条件从文本中移除粗体,则返回 false
。如果粗体显示不受影响,则返回 null
。
// Logs the boolean condition font weight for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var bold = rules[i].getBooleanCondition().getBold(); Logger.log("The font bold setting for rule %s is %b", i, weight); }
弃踢回攻
Boolean
- 是否布尔条件加粗文本,若不受影响,则设为 null
getCriteriaType()
获取 BooleanCriteria
枚举中定义的规则的条件类型。如需获取条件的参数,请使用 getCriteriaValues()
。如需使用这些值创建或修改条件格式规则,请参阅 ConditionalFormatRuleBuilder.withCriteria(criteria, args)
。
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
弃踢回攻
BooleanCriteria
- 条件格式设置条件的类型
getCriteriaValues()
获取规则条件的参数数组。如需获取条件类型,请使用 getCriteriaType()
。如需使用这些值创建或修改条件格式规则,请参阅 ConditionalFormatRuleBuilder.withCriteria(criteria, args)
。
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
弃踢回攻
Object[]
- 适合规则的条件类型的参数数组;参数的数量和类型与 ConditionalFormatRuleBuilder
类的相应 when...()
方法一致
getFontColorObject()
获取此布尔值条件的字体颜色。如果未设置,则返回 null
。
// Logs the boolean condition font color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getFontColorObject(); Logger.log("The font color for rule %s is %s", i, color.asRgbColor().asHexString()); }
弃踢回攻
Color
- 字体颜色,如果未针对此条件设置,则为 null
。
getItalic()
如果此布尔条件将文本设为斜体,则返回 true
;如果此布尔条件移除文本的斜体,则返回 false
。如果斜体不受影响,则返回 null
。
// Logs the boolean condition font style for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var italic = rules[i].getBooleanCondition().getItalic(); Logger.log("The font italic setting for rule %s is %b", i, italic); }
弃踢回攻
Boolean
- 布尔值条件是否将文本设为斜体,如果斜体未影响,则返回 null
getStrikethrough()
如果此布尔条件删除文本,则返回 true
;如果此布尔条件从文本中移除删除线,则返回 false
。如果删除线不受影响,则返回 null
。
// Logs the boolean condition strikethrough setting for each conditional format rule on a // sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var strikethrough = rules[i].getBooleanCondition().getStrikethrough(); Logger.log("The font strikethrough setting for rule %s is %b", i, strikethrough); }
弃踢回攻
Boolean
- 布尔值条件是否删除文本,如果删除线不受影响,则为 null
getUnderline()
如果此布尔条件为文本添加下划线,则返回 true
;如果此布尔条件移除文本的下划线,则返回 false
。如果下划线不受影响,则返回 null
。
// Logs the boolean condition underline setting for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var underline = rules[i].getBooleanCondition().getUnderline(); Logger.log("The font underline setting for rule %s is %b", i, underline); }
弃踢回攻
Boolean
- 布尔值条件是否为文本添加下划线,如果下划线不受影响,则为 null