หน้านี้ได้รับการแปลโดย Cloud Translation API

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`	รับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getMaxColor()`	`String`	รับชุดสีสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้
`getMidColor()`	`String`	รับชุดสีสำหรับค่ากลางของเงื่อนไขการไล่ระดับสีนี้
`getMinColor()`	`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 — ค่าต่ำสุดหากระบุไว้หรือสตริงว่าง

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

`getMaxColor()`

เลิกใช้งานแล้ว แทนที่โดย getMaxColorObject()

รับชุดสีสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผลสตริงว่างหากไม่ได้ตั้งค่าสี

รีเทิร์น

String — สีที่กำหนดสำหรับค่าสูงสุดของเงื่อนไขการไล่ระดับสีนี้หรือสตริงว่าง

`getMidColor()`

เลิกใช้งานแล้ว แทนที่โดย getMidColorObject()

รับชุดสีสำหรับค่ากลางของเงื่อนไขการไล่ระดับสีนี้ แสดงผลสตริงว่างหากไม่ได้ตั้งค่าสี

รีเทิร์น

String — สีที่กำหนดสำหรับค่ากลางของเงื่อนไขการไล่ระดับสีนี้หรือสตริงว่าง

`getMinColor()`

เลิกใช้งานแล้ว แทนที่โดย getMinColorObject()

รับชุดสีสำหรับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ แสดงผลสตริงว่างหากไม่ได้ตั้งค่าสี

รีเทิร์น

String — สีที่กำหนดสำหรับค่าต่ำสุดของเงื่อนไขการไล่ระดับสีนี้ หรือสตริงว่าง