Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

เครื่องมือสร้างสำหรับกฎการจัดรูปแบบตามเงื่อนไข

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
build()ConditionalFormatRuleสร้างกฎการจัดรูปแบบตามเงื่อนไขจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง
copy()ConditionalFormatRuleBuilderแสดงผลค่าที่กำหนดล่วงหน้าของตัวสร้างกฎพร้อมการตั้งค่าของกฎนี้
getBooleanCondition()BooleanConditionเรียกข้อมูล BooleanCondition ของกฎหากกฎนี้ใช้ เกณฑ์ของเงื่อนไขบูลีน
getGradientCondition()GradientConditionเรียกข้อมูล GradientCondition ของกฎ หากกฎนี้ ใช้เกณฑ์เงื่อนไขการไล่ระดับสี
getRanges()Range[]เรียกข้อมูลช่วงที่ใช้กฎการจัดรูปแบบตามเงื่อนไขนี้
setBackground(color)ConditionalFormatRuleBuilderตั้งค่าสีพื้นหลังให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข
setBackgroundObject(color)ConditionalFormatRuleBuilderตั้งค่าสีพื้นหลังให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข
setBold(bold)ConditionalFormatRuleBuilderตั้งค่าการทำให้ข้อความเป็นตัวหนาสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข
setFontColor(color)ConditionalFormatRuleBuilderตั้งค่าสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข
setFontColorObject(color)ConditionalFormatRuleBuilderตั้งค่าสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข
setGradientMaxpoint(color)ConditionalFormatRuleBuilderล้างค่าจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดแทน ในช่วงของกฎ
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderล้างค่าจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดแทน ในช่วงของกฎ
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าช่องจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าช่องจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าช่องจุดกึ่งกลางการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าช่องจุดกึ่งกลางการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข
setGradientMinpoint(color)ConditionalFormatRuleBuilderล้างค่าจุดการไล่ระดับสีของกฎรูปแบบตามเงื่อนไขและใช้ค่าต่ำสุดแทน ในช่วงของกฎ
setGradientMinpointObject(color)ConditionalFormatRuleBuilderล้างค่าจุดการไล่ระดับสีของกฎรูปแบบตามเงื่อนไขและใช้ค่าต่ำสุดแทน ในช่วงของกฎ
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าช่องจุดต่ำสุดของการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderตั้งค่าช่องจุดต่ำสุดของการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข
setItalic(italic)ConditionalFormatRuleBuilderตั้งค่าตัวเอียงข้อความสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข
setRanges(ranges)ConditionalFormatRuleBuilderตั้งค่าช่วงอย่างน้อย 1 ช่วงที่จะใช้กฎรูปแบบตามเงื่อนไขนี้
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderตั้งค่าการขีดทับข้อความสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข
setUnderline(underline)ConditionalFormatRuleBuilderตั้งค่าขีดเส้นใต้ข้อความสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข
whenCellEmpty()ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อเซลล์ว่างเปล่า
whenCellNotEmpty()ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อเซลล์ไม่ว่างเปล่า
whenDateAfter(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่อยู่หลังค่าที่ระบุ
whenDateAfter(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่อยู่หลังวันที่สัมพัทธ์ที่ระบุ
whenDateBefore(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออยู่ก่อนวันที่ที่กำหนด
whenDateBefore(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่อยู่ก่อนวันที่สัมพัทธ์ที่ระบุ
whenDateEqualTo(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่เท่ากับวันที่ที่ระบุ
whenDateEqualTo(date)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่เท่ากับวันที่สัมพัทธ์ที่ระบุ
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อสูตรที่ระบุประเมินเป็น true
whenNumberBetween(start, end)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขอยู่ระหว่าง หรือเป็นจำนวน 2 ค่าที่ระบุ
whenNumberEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขเท่ากับค่าที่ระบุ
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อตัวเลขมากกว่าค่าที่ระบุ
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขมากกว่าหรือเท่ากับที่ระบุ
whenNumberLessThan(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อตัวเลขน้อยกว่าที่ระบุ
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขน้อยกว่าหรือเท่ากับที่ระบุ
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่อยู่ระหว่าง และไม่ทั้งคู่ ค่าที่ระบุ 2 ค่า
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่เท่ากับค่าที่ระบุ
whenTextContains(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตมีค่าที่กำหนด
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตนั้นไม่มี
whenTextEndsWith(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตนั้นสิ้นสุดด้วยค่าที่กำหนด
whenTextEqualTo(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตเท่ากับค่าที่กำหนด
whenTextStartsWith(text)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตนั้นขึ้นต้นด้วยค่าที่กำหนด
withCriteria(criteria, args)ConditionalFormatRuleBuilderตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเป็นเกณฑ์ที่กำหนดโดยค่า BooleanCriteria โดยทั่วไปแล้วมาจาก criteria และ arguments ของ กฎที่มีอยู่

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

build()

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

รีเทิร์น

ConditionalFormatRule — ตัวแทนของกฎการจัดรูปแบบตามเงื่อนไข


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[] — ช่วงที่ใช้กฎการจัดรูปแบบตามเงื่อนไขนี้


setBackground(color)

ตั้งค่าสีพื้นหลังให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข จะผ่านใน null จะนำการตั้งค่ารูปแบบสีพื้นหลังออกจากกฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีที่ต้องการหรือnullที่จะล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setBackgroundObject(color)

ตั้งค่าสีพื้นหลังให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข จะผ่านใน null จะนำการตั้งค่ารูปแบบสีพื้นหลังออกจากกฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to theme background color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorวัตถุสีที่ต้องการหรือ null ที่จะล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่


setBold(bold)

ตั้งค่าการทำให้ข้อความเป็นตัวหนาสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข หาก bold คือtrue กฎจะทำให้ข้อความเป็นตัวหนาหากเป็นไปตามเงื่อนไข หากเป็น false กฎจะนำคอลัมน์ที่มีอยู่ แสดงเป็นตัวหนาเมื่อตรงตามเงื่อนไข การส่งผ่านใน null จะนำการตั้งค่ารูปแบบตัวหนาออกจาก กฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text bold if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
boldBooleanระบุว่าข้อความควรเป็นตัวหนาหรือไม่หากเป็นไปตามเงื่อนไขรูปแบบ null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setFontColor(color)

ตั้งค่าสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข การผ่านใน null จะนำออก การตั้งค่ารูปแบบสีแบบอักษร จากกฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีที่ต้องการหรือnullที่จะล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setFontColorObject(color)

ตั้งค่าสีแบบอักษรให้กับรูปแบบของกฎรูปแบบตามเงื่อนไข การผ่านใน null จะนำออก การตั้งค่ารูปแบบสีแบบอักษร จากกฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to theme text color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorวัตถุสีที่ต้องการหรือ null ที่จะล้าง

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่


setGradientMaxpoint(color)

ล้างค่าจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดแทน ในช่วงของกฎ และตั้งค่าสี maxpoint ของการไล่ระดับสีเป็นสีอินพุตด้วย

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีจุดสูงสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setGradientMaxpointObject(color)

ล้างค่าจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข และใช้ค่าสูงสุดแทน ในช่วงของกฎ และตั้งค่าสี maxpoint ของการไล่ระดับสีเป็นสีอินพุตด้วย

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorออบเจ็กต์สี maxpoint ที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่


setGradientMaxpointObjectWithValue(color, type, value)

ตั้งค่าช่องจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their
// values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีจุดสูงสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการประมาณค่าการประมาณค่าสูงสุดที่จะตั้งค่า
valueStringค่าคะแนนสูงสุดที่จะกำหนด

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่


setGradientMaxpointWithValue(color, type, value)

ตั้งค่าช่องจุดสูงสุดในการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีจุดสูงสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการประมาณค่าการประมาณค่าสูงสุดที่จะตั้งค่า
valueStringค่าคะแนนสูงสุดที่จะกำหนด

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setGradientMidpointObjectWithValue(color, type, value)

ตั้งค่าช่องจุดกึ่งกลางการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข ล้างช่องจุดกึ่งกลางทั้งหมด หากส่งผ่านในประเภทการประมาณค่าเป็น null

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีจุดกึ่งกลางที่ต้องการตั้งค่า
typeInterpolationTypeประเภทการประมาณค่าช่วงกึ่งกลางที่จะตั้งค่าหรือ null เพื่อล้าง
valueStringค่าจุดกึ่งกลางที่ต้องกำหนด

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่


setGradientMidpointWithValue(color, type, value)

ตั้งค่าช่องจุดกึ่งกลางการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข ล้างช่องจุดกึ่งกลางทั้งหมด หากส่งผ่านในประเภทการประมาณค่าเป็น null

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีจุดกึ่งกลางที่ต้องการตั้งค่า
typeInterpolationTypeประเภทการประมาณค่าช่วงกึ่งกลางที่จะตั้งค่าหรือ null เพื่อล้าง
valueStringค่าจุดกึ่งกลางที่ต้องกำหนด

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setGradientMinpoint(color)

ล้างค่าจุดการไล่ระดับสีของกฎรูปแบบตามเงื่อนไขและใช้ค่าต่ำสุดแทน ในช่วงของกฎ และตั้งค่าสีจุดต่ำสุดของการไล่ระดับสีเป็นสีอินพุตด้วย

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีจุดต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setGradientMinpointObject(color)

ล้างค่าจุดการไล่ระดับสีของกฎรูปแบบตามเงื่อนไขและใช้ค่าต่ำสุดแทน ในช่วงของกฎ และตั้งค่าสีจุดต่ำสุดของการไล่ระดับสีเป็นสีอินพุตด้วย

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorออบเจ็กต์สีต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่


setGradientMinpointObjectWithValue(color, type, value)

ตั้งค่าช่องจุดต่ำสุดของการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorColorสีจุดต่ำสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการประมาณค่าต่ำสุดของจุดที่จะตั้งค่า
valueStringค่าต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำสายโซ่


setGradientMinpointWithValue(color, type, value)

ตั้งค่าช่องจุดต่ำสุดของการไล่ระดับสีของกฎรูปแบบตามเงื่อนไข

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red to green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
colorStringสีจุดต่ำสุดที่จะตั้งค่า
typeInterpolationTypeประเภทการประมาณค่าต่ำสุดของจุดที่จะตั้งค่า
valueStringค่าต่ำสุดที่จะตั้งค่า

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setItalic(italic)

ตั้งค่าตัวเอียงข้อความสำหรับรูปแบบของกฎการจัดรูปแบบตามเงื่อนไข หาก italic คือtrue กฎจะทำให้ข้อความเป็นตัวเอียงหากเป็นไปตามเงื่อนไข หากเป็น false กฎจะนำรายการต่อไปนี้ออก ตัวเอียงที่มีอยู่หากเป็นไปตามเงื่อนไข การส่งผ่านในภาษา null จะทำให้ระบบนำตัวเอียงออก การตั้งค่ารูปแบบจากกฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text italic if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setItalic(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
italicBooleanข้อความควรเป็นตัวเอียงหรือไม่หากเป็นไปตามเงื่อนไขของรูปแบบ null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setRanges(ranges)

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

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6
// to turn red if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rangesRange[]ช่วงที่ใช้กฎการจัดรูปแบบตามเงื่อนไขนี้

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setStrikethrough(strikethrough)

ตั้งค่าการขีดทับข้อความสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข หาก strikethrough คือ true ข้อความกฎจะขีดทับข้อความหากเป็นไปตามเงื่อนไข หากเป็น false กฎ นำการจัดรูปแบบขีดทับที่มีอยู่ออกหากเป็นไปตามเงื่อนไข จะผ่านใน null จะนำการตั้งค่ารูปแบบขีดทับออกจากกฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setStrikethrough(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
strikethroughBooleanข้อความควรขีดทับหรือไม่หากเงื่อนไขรูปแบบคือ met; null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


setUnderline(underline)

ตั้งค่าขีดเส้นใต้ข้อความสำหรับรูปแบบของกฎรูปแบบตามเงื่อนไข หาก underline คือ true กฎจะขีดเส้นใต้ข้อความหากเป็นไปตามเงื่อนไข หากเป็น false กฎจะนำรายการต่อไปนี้ออก ขีดเส้นใต้ไว้หากเป็นไปตามเงื่อนไข การส่งผ่านใน null ทำให้เส้นใต้ออก การตั้งค่ารูปแบบจากกฎ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
underlineBooleanควรขีดเส้นใต้ข้อความหรือไม่หากเป็นไปตามเงื่อนไขรูปแบบ null นำการตั้งค่านี้ออก

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenCellEmpty()

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อเซลล์ว่างเปล่า

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenCellNotEmpty()

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อเซลล์ไม่ว่างเปล่า

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are not empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenDateAfter(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่อยู่หลังค่าที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ล่าสุด

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenDateAfter(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่อยู่หลังวันที่สัมพัทธ์ที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ล่าสุดที่สัมพันธ์กับประเภทวันที่ที่เลือก

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenDateBefore(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออยู่ก่อนวันที่ที่กำหนด

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่แรกสุดที่ไม่อนุมัติ

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenDateBefore(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่อยู่ก่อนวันที่สัมพัทธ์ที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ล่าสุดที่สัมพันธ์กับประเภทวันที่ที่เลือก

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenDateEqualTo(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่เท่ากับวันที่ที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the date 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ยอมรับวันเดียว

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenDateEqualTo(date)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อวันที่เท่ากับวันที่สัมพัทธ์ที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain todays date.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ล่าสุดที่สัมพันธ์กับประเภทวันที่ที่เลือก

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenFormulaSatisfied(formula)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อสูตรที่ระบุประเมินเป็น true

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they satisfy the condition "=EQ(B4, C3)".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied("=EQ(B4, C3)")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulaStringสูตรที่กำหนดเองซึ่งประเมินค่าเป็น true หากอินพุตถูกต้อง

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberBetween(start, end)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขอยู่ระหว่าง หรือเป็นจำนวน 2 ค่าที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberค่าต่ำสุดที่ยอมรับได้
endNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberEqualTo(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขเท่ากับค่าที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าที่ยอมรับได้เพียงอย่างเดียว

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberGreaterThan(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อตัวเลขมากกว่าค่าที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red
// if they contain a number greater than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าสูงสุดที่ยอมรับไม่ได้

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberGreaterThanOrEqualTo(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขมากกว่าหรือเท่ากับที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number greater than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าต่ำสุดที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberLessThan(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเพื่อทริกเกอร์เมื่อตัวเลขน้อยกว่าที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าต่ำสุดที่ยอมรับไม่ได้

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberLessThanOrEqualTo(number)

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

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberNotBetween(start, end)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่อยู่ระหว่าง และไม่ทั้งคู่ ค่าที่ระบุ 2 ค่า

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number not between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberค่าต่ำสุดที่ยอมรับไม่ได้
endNumberค่าสูงสุดที่ยอมรับไม่ได้

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenNumberNotEqualTo(number)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่อตัวเลขไม่เท่ากับค่าที่ระบุ

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าที่ยอมรับไม่ได้เพียงอย่างเดียว

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenTextContains(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตมีค่าที่กำหนด

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextContains("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่อินพุตต้องมี

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenTextDoesNotContain(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตนั้นไม่มี

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextDoesNotContain("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่ใส่ต้องไม่มีค่า

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenTextEndsWith(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตนั้นสิ้นสุดด้วยค่าที่กำหนด

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they end with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่จะเปรียบเทียบกับส่วนท้ายของสตริง

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenTextEqualTo(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตเท่ากับค่าที่กำหนด

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they have text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่ยอมรับได้เพียงอย่างเดียว

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


whenTextStartsWith(text)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขให้ทริกเกอร์เมื่ออินพุตนั้นขึ้นต้นด้วยค่าที่กำหนด

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they start with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่จะเปรียบเทียบกับจุดเริ่มต้นของสตริง

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่


withCriteria(criteria, args)

ตั้งค่ากฎการจัดรูปแบบตามเงื่อนไขเป็นเกณฑ์ที่กำหนดโดยค่า BooleanCriteria โดยทั่วไปแล้วมาจาก criteria และ arguments ของ กฎที่มีอยู่

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
var booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  var rule = SpreadsheetApp.newConditionalFormatRule()
      .withCriteria(booleanCondition.getCriteriaType(),
         booleanCondition.getCriteriaValues())
      .setBackground("#000000")
      .setRanges(rule.getRanges())
      .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
criteriaBooleanCriteriaประเภทเกณฑ์รูปแบบตามเงื่อนไข
argsObject[]อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และ ประเภทของพวกเขาตรงกับเมธอด when...() ที่เกี่ยวข้องด้านบน

รีเทิร์น

ConditionalFormatRuleBuilder — เครื่องมือสร้างสำหรับการทำห่วงโซ่