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

Class ConditionalFormatRule

เข้าถึงกฎการจัดรูปแบบตามเงื่อนไข หากต้องการสร้างกฎใหม่ ให้ใช้ SpreadsheetApp.newConditionalFormatRule() และ ConditionalFormatRuleBuilder คุณใช้ Sheet.setConditionalFormatRules(rules) เพื่อตั้งค่า กฎสำหรับชีตที่ต้องการได้

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`copy()`	`ConditionalFormatRuleBuilder`	แสดงค่าที่กำหนดล่วงหน้าของเครื่องมือสร้างกฎพร้อมการตั้งค่าของกฎนี้
`getBooleanCondition()`	`BooleanCondition`	เรียกข้อมูล `BooleanCondition` ของกฎหากกฎนี้ใช้ เกณฑ์เงื่อนไขบูลีน
`getGradientCondition()`	`GradientCondition`	เรียกข้อมูล`GradientCondition`ของกฎ หากกฎนี้ ใช้เกณฑ์เงื่อนไขแบบไล่ระดับสี
`getRanges()`	`Range[]`	เรียกข้อมูลช่วงที่ใช้กฎการจัดรูปแบบตามเงื่อนไขนี้

เอกสารโดยละเอียด

`copy()`

แสดงค่าที่กำหนดล่วงหน้าของเครื่องมือสร้างกฎพร้อมการตั้งค่าของกฎนี้

รีเทิร์น

ConditionalFormatRuleBuilder - ตัวสร้างที่อิงตามการตั้งค่าของกฎนี้

`getBooleanCondition()`

เรียกข้อมูล BooleanCondition ของกฎหากกฎนี้ใช้ เกณฑ์เงื่อนไขบูลีน ไม่เช่นนั้นจะแสดงผล null

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

รีเทิร์น

BooleanCondition - ออบเจ็กต์เงื่อนไขบูลีน หรือ null หากกฎไม่ได้ใช้เงื่อนไขบูลีน

`getGradientCondition()`

เรียกข้อมูลGradientConditionของกฎ หากกฎนี้ ใช้เกณฑ์เงื่อนไขแบบไล่ระดับสี ไม่เช่นนั้นจะแสดงผล null

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

รีเทิร์น

GradientCondition — ออบเจ็กต์เงื่อนไขการไล่ระดับสี หรือ null หากกฎไม่ได้ใช้เงื่อนไขการไล่ระดับสี

`getRanges()`

เรียกข้อมูลช่วงที่ใช้กฎการจัดรูปแบบตามเงื่อนไขนี้

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

รีเทิร์น

Range[] — ช่วงที่ใช้กฎการจัดรูปแบบตามเงื่อนไขนี้