เข้าถึงกฎการจัดรูปแบบตามเงื่อนไข หากต้องการสร้างกฎใหม่ ให้ใช้ SpreadsheetApp.newConditionalFormatRule()
และ ConditionalFormatRuleBuilder
คุณใช้ Sheet.setConditionalFormatRules(rules)
เพื่อตั้งค่ากฎสำหรับชีตที่ต้องการได้
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
copy() | ConditionalFormatRuleBuilder | แสดงผลค่าที่กำหนดล่วงหน้าของเครื่องมือสร้างกฎพร้อมกับการตั้งค่าของกฎนี้ |
getBooleanCondition() | BooleanCondition | เรียกข้อมูล BooleanCondition ของกฎหากกฎนี้ใช้เกณฑ์เงื่อนไขบูลีน |
getGradientCondition() | GradientCondition | เรียกข้อมูล GradientCondition ของกฎ หากกฎนี้ใช้เกณฑ์เงื่อนไขการไล่ระดับสี |
getRanges() | Range[] | เรียกข้อมูลช่วงที่จะใช้กฎการจัดรูปแบบตามเงื่อนไขนี้ |
เอกสารประกอบโดยละเอียด
copy()
แสดงผลค่าที่กำหนดล่วงหน้าของเครื่องมือสร้างกฎพร้อมกับการตั้งค่าของกฎนี้
รีเทิร์น
ConditionalFormatRuleBuilder
— เครื่องมือสร้างตามการตั้งค่าของกฎนี้
getBooleanCondition()
เรียกข้อมูล BooleanCondition
ของกฎหากกฎนี้ใช้เกณฑ์เงื่อนไขบูลีน มิฉะนั้นจะแสดง null
// Log the boolean criteria type of the first conditional format rules of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
รีเทิร์น
BooleanCondition
— ออบเจ็กต์เงื่อนไขบูลีน หรือ null
หากกฎไม่ได้ใช้เงื่อนไขบูลีน
getGradientCondition()
เรียกข้อมูล GradientCondition
ของกฎ หากกฎนี้ใช้เกณฑ์เงื่อนไขการไล่ระดับสี มิฉะนั้นจะแสดง null
// Log the gradient minimum color of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
รีเทิร์น
GradientCondition
— ออบเจ็กต์เงื่อนไขการไล่ระดับสี หรือ null
หากกฎไม่ได้ใช้เงื่อนไขการไล่ระดับสี
getRanges()
เรียกข้อมูลช่วงที่จะใช้กฎการจัดรูปแบบตามเงื่อนไขนี้
// Log each range of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var ranges = rule.getRanges(); for (var i = 0; i < ranges.length; i++) { Logger.log(ranges[i].getA1Notation()); }
รีเทิร์น
Range[]
— ช่วงที่จะใช้กฎการจัดรูปแบบตามเงื่อนไขนี้