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 (如果) 則不會影響

已淘汰的方法