เข้าถึงเงื่อนไขการไล่ระดับสี (สี) ใน 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
— ค่าต่ำสุดหากระบุไว้หรือเป็นสตริงว่างเปล่า