Class BooleanCondition

布尔值条件

访问 ConditionalFormatRules 中的布尔值条件。每个条件格式规则可以包含一个布尔值条件。布尔值条件本身包含布尔值条件（带值）和格式设置。系统会根据单元格的内容评估条件，从而得出 true 或 false 值。如果条件的计算结果为 true，则会将该条件的格式设置应用于相应单元格。

方法

方法返回类型简介
getBackgroundObject()Color|null获取相应布尔值条件的背景颜色。
getBold()Boolean|null如果此布尔值条件使文本加粗，则返回 true；如果此布尔值条件使文本不加粗，则返回 false。
getCriteriaType()BooleanCriteria获取规则的条件类型，如 BooleanCriteria 枚举中所定义。
getCriteriaValues()Object[]获取规则条件的一组实参。
getFontColorObject()Color|null获取相应布尔值条件的字体颜色。
getItalic()Boolean|null如果此布尔值条件使文本变为斜体，则返回 true；如果此布尔值条件从文本中移除斜体，则返回 false。
getStrikethrough()Boolean|null如果此布尔值条件为文本添加删除线，则返回 true；如果此布尔值条件从文本中移除删除线，则返回 false。
getUnderline()Boolean|null如果此布尔值条件为文本添加下划线，则返回 true；如果此布尔值条件从文本中移除下划线，则返回 false。

详细文档

getBackgroundObject()

获取相应布尔值条件的背景颜色。如果未设置，则返回 null。 

// Logs the boolean condition background color for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getBackgroundObject();
  Logger.log(`Background color: ${color.asRgbColor().asHexString()}`);
}

返回

Color|null - 背景颜色，如果未针对此条件设置，则为 null。

getBold()

如果此布尔值条件使文本加粗，则返回 true；如果此布尔值条件使文本不加粗，则返回 false。如果加粗不受影响，则返回 null。 

// Logs the boolean condition font weight for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const bold = rule.getBooleanCondition().getBold();
  Logger.log(`Bold: ${bold}`);
}

返回

Boolean|null - 布尔值条件是否将文本加粗，如果加粗不受影响，则为 null

getCriteriaType()

获取规则的条件类型，如 BooleanCriteria 枚举中所定义。如需获取条件的实参，请使用 getCriteriaValues()。如需使用这些值创建或修改条件格式规则，请参阅 ConditionalFormatRuleBuilder.withCriteria(criteria, args)。 

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

返回

BooleanCriteria - 条件格式设置条件的类型。

getCriteriaValues()

获取规则条件的一组实参。如需获取条件类型，请使用 getCriteriaType()。如需使用这些值创建或修改条件格式规则，请参阅 ConditionalFormatRuleBuilder.withCriteria(criteria, args)。 

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

返回

Object[] - 适合规则条件类型的实参数组；实参的数量和类型与 ConditionalFormatRuleBuilder 类的相应 when...() 方法相匹配。

getFontColorObject()

获取相应布尔值条件的字体颜色。如果未设置，则返回 null。 

// Logs the boolean condition font color for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getFontColorObject();
  Logger.log(`Font color: ${color.asRgbColor().asHexString()}`);
}

返回

Color|null - 字体颜色，如果未为此条件设置，则为 null。

getItalic()

如果此布尔值条件使文本变为斜体，则返回 true；如果此布尔值条件从文本中移除斜体，则返回 false。如果斜体不受影响，则返回 null。 

// Logs the boolean condition font style for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const italic = rule.getBooleanCondition().getItalic();
  Logger.log(`Italic: ${italic}`);
}

返回

Boolean|null - 布尔值条件是否使文本变为斜体，或 null（如果斜体不受影响）

getStrikethrough()

如果此布尔值条件为文本添加删除线，则返回 true；如果此布尔值条件从文本中移除删除线，则返回 false。如果删除线不受影响，则返回 null。 

// Logs the boolean condition strikethrough setting for each conditional format
// rule on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const strikethrough = rule.getBooleanCondition().getStrikethrough();
  Logger.log(`Strikethrough: ${strikethrough}`);
}

返回

Boolean|null - 布尔值条件是否会使文本带有删除线，如果删除线不受影响，则为 null

getUnderline()

如果此布尔值条件为文本添加下划线，则返回 true；如果此布尔值条件从文本中移除下划线，则返回 false。如果下划线不受影响，则返回 null。 

// Logs the boolean condition underline setting for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const underline = rule.getBooleanCondition().getUnderline();
  Logger.log(`Underline: ${underline}`);
}

返回

Boolean|null - 布尔值条件是否为文本添加下划线，或 null（如果下划线不受影响）

已弃用的方法