存取 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