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

已淘汰的方法