เข้าถึงเงื่อนไขบูลีนใน ConditionalFormatRules
ชิ้น
กฎการจัดรูปแบบตามเงื่อนไขอาจมีเงื่อนไขเดียวที่เป็นบูลีน ตัวเงื่อนไขบูลีน
มีเกณฑ์บูลีน (พร้อมค่า) และการตั้งค่าการจัดรูปแบบ เกณฑ์จะได้รับการประเมิน
เทียบกับเนื้อหาของเซลล์ ซึ่งจะเป็นค่า true
หรือ false
หาก
เกณฑ์ประเมินเป็น true
ระบบจะนำการตั้งค่าการจัดรูปแบบของเงื่อนไขไปใช้กับเซลล์
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
getBackgroundObject() | Color | รับสีพื้นหลังสำหรับเงื่อนไขบูลีนนี้ |
getBold() | Boolean | แสดงผล true หากเงื่อนไขบูลีนนี้ทำให้ข้อความเป็นตัวหนาและแสดงผล false หากเป็นเช่นนี้
เงื่อนไขบูลีนจะนำตัวหนาออกจากข้อความ |
getCriteriaType() | BooleanCriteria | รับประเภทเกณฑ์ของกฎตามที่ระบุไว้ใน enum ของ 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()
รับประเภทเกณฑ์ของกฎตามที่ระบุไว้ใน enum ของ 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[]
— อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์ของกฎ จำนวนอาร์กิวเมนต์
และประเภทของพวกเขาตรงกับเมธอด when...()
ที่สอดคล้องกันของคลาส ConditionalFormatRuleBuilder
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
หาก
การขีดเส้นใต้จะไม่ได้รับผลกระทบ