Class BooleanCondition

BooleanCondition

访问 ConditionalFormatRules 中的布尔值条件。每个条件格式规则都可以包含一个布尔条件。布尔值条件本身包含一个布尔值条件(包含值)和格式设置。系统会根据单元格的内容评估条件,得出 truefalse 值。如果条件的计算结果为 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

已废弃的方法