Class GradientCondition

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 — ค่าต่ำสุดหากระบุไว้หรือสตริงว่าง

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