เครื่องมือสร้างสำหรับกฎการจัดรูปแบบตามเงื่อนไข
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีที่ต้องการหรือ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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | วัตถุสีที่ต้องการหรือ 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
bold | Boolean | ระบุว่าข้อความควรเป็นตัวหนาหรือไม่หากเป็นไปตามเงื่อนไขรูปแบบ 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีที่ต้องการหรือ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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | วัตถุสีที่ต้องการหรือ 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีจุดสูงสุดที่จะตั้งค่า |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | ออบเจ็กต์สี 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | สีจุดสูงสุดที่จะตั้งค่า |
type | InterpolationType | ประเภทการประมาณค่าการประมาณค่าสูงสุดที่จะตั้งค่า |
value | String | ค่าคะแนนสูงสุดที่จะกำหนด |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีจุดสูงสุดที่จะตั้งค่า |
type | InterpolationType | ประเภทการประมาณค่าการประมาณค่าสูงสุดที่จะตั้งค่า |
value | String | ค่าคะแนนสูงสุดที่จะกำหนด |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | สีจุดกึ่งกลางที่ต้องการตั้งค่า |
type | InterpolationType | ประเภทการประมาณค่าช่วงกึ่งกลางที่จะตั้งค่าหรือ null เพื่อล้าง |
value | String | ค่าจุดกึ่งกลางที่ต้องกำหนด |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีจุดกึ่งกลางที่ต้องการตั้งค่า |
type | InterpolationType | ประเภทการประมาณค่าช่วงกึ่งกลางที่จะตั้งค่าหรือ null เพื่อล้าง |
value | String | ค่าจุดกึ่งกลางที่ต้องกำหนด |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีจุดต่ำสุดที่จะตั้งค่า |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | ออบเจ็กต์สีต่ำสุดที่จะตั้งค่า |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | สีจุดต่ำสุดที่จะตั้งค่า |
type | InterpolationType | ประเภทการประมาณค่าต่ำสุดของจุดที่จะตั้งค่า |
value | String | ค่าต่ำสุดที่จะตั้งค่า |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีจุดต่ำสุดที่จะตั้งค่า |
type | InterpolationType | ประเภทการประมาณค่าต่ำสุดของจุดที่จะตั้งค่า |
value | String | ค่าต่ำสุดที่จะตั้งค่า |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
italic | Boolean | ข้อความควรเป็นตัวเอียงหรือไม่หากเป็นไปตามเงื่อนไขของรูปแบบ
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
ranges | Range[] | ช่วงที่ใช้กฎการจัดรูปแบบตามเงื่อนไขนี้ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
strikethrough | Boolean | ข้อความควรขีดทับหรือไม่หากเงื่อนไขรูปแบบคือ
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
underline | Boolean | ควรขีดเส้นใต้ข้อความหรือไม่หากเป็นไปตามเงื่อนไขรูปแบบ
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่ล่าสุด |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | RelativeDate | วันที่ล่าสุดที่สัมพันธ์กับประเภทวันที่ที่เลือก |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่แรกสุดที่ไม่อนุมัติ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | RelativeDate | วันที่ล่าสุดที่สัมพันธ์กับประเภทวันที่ที่เลือก |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่ยอมรับวันเดียว |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | RelativeDate | วันที่ล่าสุดที่สัมพันธ์กับประเภทวันที่ที่เลือก |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formula | String | สูตรที่กำหนดเองซึ่งประเมินค่าเป็น 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
start | Number | ค่าต่ำสุดที่ยอมรับได้ |
end | Number | ค่าสูงสุดที่ยอมรับได้ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | ค่าที่ยอมรับได้เพียงอย่างเดียว |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | ค่าสูงสุดที่ยอมรับไม่ได้ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | ค่าต่ำสุดที่ยอมรับได้ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | ค่าต่ำสุดที่ยอมรับไม่ได้ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | ค่าสูงสุดที่ยอมรับได้ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
start | Number | ค่าต่ำสุดที่ยอมรับไม่ได้ |
end | Number | ค่าสูงสุดที่ยอมรับไม่ได้ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | ค่าที่ยอมรับไม่ได้เพียงอย่างเดียว |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ค่าที่อินพุตต้องมี |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ค่าที่ใส่ต้องไม่มีค่า |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่จะเปรียบเทียบกับส่วนท้ายของสตริง |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ค่าที่ยอมรับได้เพียงอย่างเดียว |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่จะเปรียบเทียบกับจุดเริ่มต้นของสตริง |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
criteria | BooleanCriteria | ประเภทเกณฑ์รูปแบบตามเงื่อนไข |
args | Object[] | อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และ
ประเภทของพวกเขาตรงกับเมธอด when...() ที่เกี่ยวข้องด้านบน |
รีเทิร์น
ConditionalFormatRuleBuilder
— เครื่องมือสร้างสำหรับการทำห่วงโซ่