Class GradientCondition

GradientCondition

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

วิธีการที่เลิกใช้งานแล้ว