Class ConditionalFormatRule

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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

รีเทิร์น

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