Class BooleanCondition

BooleanCondition

访问 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 下划线不受影响

已弃用的方法