เข้าถึงเงื่อนไขบูลีนใน 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
หากการขีดเส้นใต้ไม่มีผล