Class GradientCondition

สภาพการไล่ระดับสี

เข้าถึงเงื่อนไขการไล่ระดับ (สี) ใน ConditionalFormatRuleApis กฎการจัดรูปแบบตามเงื่อนไขแต่ละข้ออาจมีเงื่อนไขการไล่ระดับสีเดียว เงื่อนไขการไล่ระดับสี กำหนดโดยจุด 3 จุดตามสเกลตัวเลข (ต่ำสุด กลาง และสูงสุด) ซึ่งแต่ละจุดจะมีสี ค่า และInterpolationType เนื้อหาของเซลล์จะ เปรียบเทียบกับค่าในมาตราส่วนตัวเลข และสีที่ใช้กับเซลล์จะได้รับการประมาณค่า โดยอิงตามความใกล้เคียงของเนื้อหาเซลล์กับจุดต่ำสุด กลาง และสูงสุดของเงื่อนไขการไล่ระดับสี

// Logs all the information inside gradient conditional format rules on a sheet.
// The below snippet assumes all colors have ColorType.RGB.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (let i = 0; i < rules.length; i++) {
  const gradient = rules[i].getGradientCondition();

  const minColor = gradient.getMinColorObject().asRgbColor().asHexString();
  const minType = gradient.getMinType();
  const minValue = gradient.getMinValue();
  const midColor = gradient.getMidColorObject().asRgbColor().asHexString();
  const midType = gradient.getMidType();
  const midValue = gradient.getMidValue();
  const maxColor = gradient.getMaxColorObject().asRgbColor().asHexString();
  const maxType = gradient.getMaxType();
  const maxValue = gradient.getMaxValue();

  Logger.log(`The conditional format gradient information for rule ${i}:
    MinColor ${minColor}, MinType ${minType}, MinValue ${minValue},
    MidColor ${midColor}, MidType ${midType}, MidValue ${midValue},
    MaxColor ${maxColor}, MaxType ${maxType}, MaxValue ${maxValue}`);
}

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
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 — ค่าต่ำสุดหากระบุไว้ หรือสตริงว่าง

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