เข้าถึงเงื่อนไขการไล่ระดับสี (color) ใน ConditionalFormatRuleApis
กฎการจัดรูปแบบตามเงื่อนไขแต่ละรายการอาจมีเงื่อนไขการไล่ระดับสีเดียว เงื่อนไขการไล่ระดับสีคือ
กำหนดโดยจุด 3 จุดตามสเกลตัวเลข (ต่ำสุด กลาง และสูงสุด) แต่ละจุดมีสี
และ InterpolationType
เนื้อหาของเซลล์คือ
เมื่อเทียบกับค่าในสเกลตัวเลขและมีการประมาณสีที่ใช้กับเซลล์
ขึ้นอยู่กับระยะใกล้/ไกลของเนื้อหาของเซลล์กับเงื่อนไขการไล่ระดับสี ต่ำสุด กึ่งกลาง และสูงสุด
// Logs all the information inside gradient conditional format rules on a sheet. // The below snippet assumes all colors have ColorType.RGB. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var gradient = rules[i].getGradientCondition(); Logger.log("The conditional format gradient information for rule %d:\n MinColor %s, MinType %s, MinValue %s, \n MidColor %s, MidType %s, MidValue %s, \n MaxColor %s, MaxType %s, MaxValue %s \n", i, gradient.getMinColorObject().asRgbColor().asHexString(), gradient.getMinType(), gradient.getMinValue(), gradient.getMidColorObject().asRgbColor().asHexString(), gradient.getMidType(), gradient.getMidValue(), gradient.getMaxColorObject().asRgbColor().asHexString(), gradient.getMaxType(), gradient.getMaxValue()); }
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
getMaxColorObject() | Color | รับชุดสีสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้ |
getMaxType() | InterpolationType | รับประเภทการประมาณค่าสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้ |
getMaxValue() | String | รับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้ |
getMidColorObject() | Color | รับชุดสีสำหรับค่าจุดกึ่งกลางของเงื่อนไขการไล่ระดับสีนี้ |
getMidType() | InterpolationType | รับประเภทการประมาณค่าในช่วงสำหรับค่าจุดกึ่งกลางของเงื่อนไขการไล่ระดับสีนี้ |
getMidValue() | String | รับค่าจุดกึ่งกลางของเงื่อนไขการไล่ระดับสีนี้ |
getMinColorObject() | Color | รับชุดสีสำหรับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ |
getMinType() | InterpolationType | รับประเภทการประมาณค่าสำหรับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ |
getMinValue() | String | รับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ |
เอกสารโดยละเอียด
getMaxColorObject()
รับชุดสีสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผล null
หาก
ยังไม่ได้ตั้งค่าสี
รีเทิร์น
Color
— สีที่กำหนดให้ค่าสูงสุดของเงื่อนไขการไล่ระดับสีหรือ null
getMaxType()
รับประเภทการประมาณค่าสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผล null
หากไม่มีการตั้งค่าประเภทการไล่ระดับสีสูงสุด
รีเทิร์น
InterpolationType
— ประเภทการประมาณค่าสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีหรือ null
นี้
getMaxValue()
รับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผลสตริงว่างหาก InterpolationType
เป็น MAX
หรือหากค่าสูงสุดไม่ใช่ค่า
ตั้งค่า
รีเทิร์น
String
— ค่าสูงสุดหากระบุไว้หรือเป็นสตริงว่าง
getMidColorObject()
รับชุดสีสำหรับค่าจุดกึ่งกลางของเงื่อนไขการไล่ระดับสีนี้ แสดงผล null
หาก
ยังไม่ได้ตั้งค่าสี
รีเทิร์น
Color
— ชุดสีสำหรับค่าจุดกึ่งกลางของเงื่อนไขการไล่ระดับสีหรือ null
getMidType()
รับประเภทการประมาณค่าในช่วงสำหรับค่าจุดกึ่งกลางของเงื่อนไขการไล่ระดับสีนี้ แสดงผล null
หากไม่มีการตั้งค่าประเภทช่วงกลางของการไล่ระดับสี
รีเทิร์น
InterpolationType
— ประเภทการประมาณค่าในช่วงกลางของเงื่อนไขการไล่ระดับสีหรือ null
getMidValue()
รับค่าจุดกึ่งกลางของเงื่อนไขการไล่ระดับสีนี้ แสดงสตริงว่างถ้าการไล่ระดับสี ยังไม่ได้กำหนดค่ากลาง
รีเทิร์น
String
— ค่ากึ่งกลางหรือสตริงว่าง
getMinColorObject()
รับชุดสีสำหรับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผล null
หาก
ยังไม่ได้ตั้งค่าสี
รีเทิร์น
Color
— สีที่กำหนดให้เป็นค่าต่ำสุดของเงื่อนไขการไล่ระดับสีหรือ null
getMinType()
รับประเภทการประมาณค่าสำหรับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผล null
หากไม่มีการตั้งค่าประเภทต่ำสุดของการไล่ระดับสี
รีเทิร์น
InterpolationType
— ประเภทการประมาณค่าสำหรับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีหรือ null
นี้
getMinValue()
รับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผลสตริงว่างหาก InterpolationType
เป็น MIN
หรือหากค่าต่ำสุดไม่ใช่ค่าขั้นต่ำ
ตั้งค่า
รีเทิร์น
String
— ค่าต่ำสุดหากระบุไว้หรือเป็นสตริงว่าง