Builder untuk aturan format bersyarat.
// 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);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
build() | ConditionalFormatRule | Membuat aturan format bersyarat dari setelan yang diterapkan ke builder. |
copy() | ConditionalFormatRuleBuilder | Menampilkan preset pembuat aturan dengan setelan aturan ini. |
getBooleanCondition() | BooleanCondition | Mengambil informasi BooleanCondition aturan jika aturan ini menggunakan kriteria kondisi boolean. |
getGradientCondition() | GradientCondition | Mengambil informasi GradientCondition aturan, jika aturan ini menggunakan kriteria kondisi gradien. |
getRanges() | Range[] | Mengambil rentang tempat aturan format bersyarat ini diterapkan. |
setBackground(color) | ConditionalFormatRuleBuilder | Menetapkan warna latar belakang untuk format aturan format bersyarat. |
setBackgroundObject(color) | ConditionalFormatRuleBuilder | Menetapkan warna latar belakang untuk format aturan format bersyarat. |
setBold(bold) | ConditionalFormatRuleBuilder | Menyetel huruf tebal teks untuk format aturan format bersyarat. |
setFontColor(color) | ConditionalFormatRuleBuilder | Menetapkan warna font untuk format aturan format bersyarat. |
setFontColorObject(color) | ConditionalFormatRuleBuilder | Menetapkan warna font untuk format aturan format bersyarat. |
setGradientMaxpoint(color) | ConditionalFormatRuleBuilder | Menghapus nilai maxpoint gradien dari aturan format bersyarat dan menggunakan nilai maksimum dalam rentang aturan. |
setGradientMaxpointObject(color) | ConditionalFormatRuleBuilder | Menghapus nilai maxpoint gradien dari aturan format bersyarat dan menggunakan nilai maksimum dalam rentang aturan. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Menetapkan kolom maxpoint gradien aturan format bersyarat. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Menetapkan kolom maxpoint gradien aturan format bersyarat. |
setGradientMidpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Menetapkan kolom titik tengah gradien aturan format bersyarat. |
setGradientMidpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Menetapkan kolom titik tengah gradien aturan format bersyarat. |
setGradientMinpoint(color) | ConditionalFormatRuleBuilder | Menghapus nilai minpoint gradien dari aturan format bersyarat dan menggunakan nilai minimum dalam rentang aturan. |
setGradientMinpointObject(color) | ConditionalFormatRuleBuilder | Menghapus nilai minpoint gradien dari aturan format bersyarat dan menggunakan nilai minimum dalam rentang aturan. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Menetapkan kolom minpoint gradien dari aturan format bersyarat. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Menetapkan kolom minpoint gradien dari aturan format bersyarat. |
setItalic(italic) | ConditionalFormatRuleBuilder | Menyetel teks miring untuk format aturan format bersyarat. |
setRanges(ranges) | ConditionalFormatRuleBuilder | Menetapkan satu atau beberapa rentang tempat aturan format bersyarat ini diterapkan. |
setStrikethrough(strikethrough) | ConditionalFormatRuleBuilder | Menetapkan teks yang dicoret untuk format aturan format bersyarat. |
setUnderline(underline) | ConditionalFormatRuleBuilder | Menetapkan teks yang digarisbawahi untuk format aturan format bersyarat. |
whenCellEmpty() | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat sel kosong. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat sel tidak kosong. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika tanggal setelah nilai yang diberikan. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika tanggal melebihi tanggal relatif yang ditentukan. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika tanggal sebelum tanggal yang ditentukan. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika tanggal lebih awal dari tanggal relatif yang ditentukan. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat tanggal sama dengan tanggal yang ditentukan. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika suatu tanggal sama dengan tanggal relatif yang ditentukan. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat formula yang ditentukan bernilai true . |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu ketika suatu angka berada di antara, atau salah satu dari, dua nilai yang ditentukan. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat suatu angka sama dengan nilai yang diberikan. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat angka lebih besar dari nilai yang diberikan. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat suatu angka lebih besar dari atau sama dengan nilai yang diberikan. |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat untuk dipicu ketika angka lebih kecil dari nilai yang ditentukan. |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika suatu angka kurang dari atau sama dengan nilai yang ditentukan. |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat untuk dipicu ketika suatu angka tidak berada di antara, dan bukan dari, dua nilai yang ditentukan. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat suatu angka tidak sama dengan nilai yang diberikan. |
whenTextContains(text) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika input berisi nilai yang diberikan. |
whenTextDoesNotContain(text) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika input tersebut tidak berisi nilai yang ditentukan. |
whenTextEndsWith(text) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat input diakhiri dengan nilai yang diberikan. |
whenTextEqualTo(text) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu jika input tersebut sama dengan nilai yang diberikan. |
whenTextStartsWith(text) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat yang akan dipicu saat input tersebut dimulai dengan nilai yang diberikan. |
withCriteria(criteria, args) | ConditionalFormatRuleBuilder | Menetapkan aturan format bersyarat ke kriteria yang ditentukan oleh nilai BooleanCriteria , biasanya diambil dari criteria dan arguments aturan yang sudah ada. |
Dokumentasi mendetail
build()
Membuat aturan format bersyarat dari setelan yang diterapkan ke builder.
Return
ConditionalFormatRule
— representasi aturan format bersyarat
copy()
Menampilkan preset pembuat aturan dengan setelan aturan ini.
Return
ConditionalFormatRuleBuilder
— builder berdasarkan setelan aturan ini
getBooleanCondition()
Mengambil informasi BooleanCondition
aturan jika aturan ini menggunakan kriteria kondisi boolean. Jika tidak, tampilkan 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()); }
Return
BooleanCondition
— objek kondisi boolean, atau null
jika aturan tidak menggunakan kondisi boolean.
getGradientCondition()
Mengambil informasi GradientCondition
aturan, jika aturan ini menggunakan kriteria kondisi gradien. Jika tidak, tampilkan 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()); }
Return
GradientCondition
— Objek kondisi gradien, atau null
jika aturan tidak menggunakan kondisi gradien.
getRanges()
Mengambil rentang tempat aturan format bersyarat ini diterapkan.
// 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()); }
Return
Range[]
— rentang tempat aturan format bersyarat ini diterapkan.
setBackground(color)
Menetapkan warna latar belakang untuk format aturan format bersyarat. Meneruskan null
akan menghapus setelan format warna latar belakang dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna yang diinginkan atau null untuk menghapus. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setBackgroundObject(color)
Menetapkan warna latar belakang untuk format aturan format bersyarat. Meneruskan null
akan menghapus setelan format warna latar belakang dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | Color | Objek warna yang diinginkan atau null yang akan dihapus. |
Return
ConditionalFormatRuleBuilder
— Builder untuk membuat rantai.
setBold(bold)
Menyetel huruf tebal teks untuk format aturan format bersyarat. Jika bold
adalah true
, aturan akan menebalkan teks jika kondisinya terpenuhi; jika false
, aturan akan menghapus cetak tebal yang ada jika kondisi terpenuhi. Meneruskan null
akan menghapus setelan format tebal dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
bold | Boolean | Apakah teks harus dicetak tebal atau tidak jika kondisi format terpenuhi; null akan menghapus setelan ini. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setFontColor(color)
Menetapkan warna font untuk format aturan format bersyarat. Meneruskan null
akan menghapus
setelan format warna font dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna yang diinginkan atau null untuk menghapus. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setFontColorObject(color)
Menetapkan warna font untuk format aturan format bersyarat. Meneruskan null
akan menghapus
setelan format warna font dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | Color | Objek warna yang diinginkan atau null yang akan dihapus. |
Return
ConditionalFormatRuleBuilder
— Builder untuk membuat rantai.
setGradientMaxpoint(color)
Menghapus nilai maxpoint gradien dari aturan format bersyarat dan menggunakan nilai maksimum dalam rentang aturan. Juga menyetel warna maxpoint gradien ke warna input.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna titik maksimal yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setGradientMaxpointObject(color)
Menghapus nilai maxpoint gradien dari aturan format bersyarat dan menggunakan nilai maksimum dalam rentang aturan. Juga menyetel warna maxpoint gradien ke warna input.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | Color | Objek warna maxpoint yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— Builder untuk membuat rantai.
setGradientMaxpointObjectWithValue(color, type, value)
Menetapkan kolom maxpoint gradien aturan format bersyarat.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | Color | Warna titik maksimal yang akan ditetapkan. |
type | InterpolationType | Jenis interpolasi maxpoint yang akan ditetapkan. |
value | String | Nilai maxpoint yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— Builder untuk membuat rantai.
setGradientMaxpointWithValue(color, type, value)
Menetapkan kolom maxpoint gradien aturan format bersyarat.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna titik maksimal yang akan ditetapkan. |
type | InterpolationType | Jenis interpolasi maxpoint yang akan ditetapkan. |
value | String | Nilai maxpoint yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setGradientMidpointObjectWithValue(color, type, value)
Menetapkan kolom titik tengah gradien aturan format bersyarat. Menghapus semua kolom titik tengah
jika jenis interpolasi yang diteruskan adalah 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | Color | Warna titik tengah yang akan ditetapkan. |
type | InterpolationType | Jenis interpolasi titik tengah yang akan ditetapkan atau null untuk dihapus. |
value | String | Nilai titik tengah yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— Builder untuk membuat rantai.
setGradientMidpointWithValue(color, type, value)
Menetapkan kolom titik tengah gradien aturan format bersyarat. Menghapus semua kolom titik tengah
jika jenis interpolasi yang diteruskan adalah 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna titik tengah yang akan ditetapkan. |
type | InterpolationType | Jenis interpolasi titik tengah yang akan ditetapkan atau null untuk dihapus. |
value | String | Nilai titik tengah yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setGradientMinpoint(color)
Menghapus nilai minpoint gradien dari aturan format bersyarat dan menggunakan nilai minimum dalam rentang aturan. Juga menyetel warna minpoint gradien ke warna input.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna minpoint yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setGradientMinpointObject(color)
Menghapus nilai minpoint gradien dari aturan format bersyarat dan menggunakan nilai minimum dalam rentang aturan. Juga menyetel warna minpoint gradien ke warna input.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | Color | Objek warna minpoint yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— Builder untuk membuat rantai.
setGradientMinpointObjectWithValue(color, type, value)
Menetapkan kolom minpoint gradien dari aturan format bersyarat.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | Color | Warna minpoint yang akan ditetapkan. |
type | InterpolationType | Jenis interpolasi minpoint yang akan ditetapkan. |
value | String | Nilai minpoint yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— Builder untuk membuat rantai.
setGradientMinpointWithValue(color, type, value)
Menetapkan kolom minpoint gradien dari aturan format bersyarat.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna minpoint yang akan ditetapkan. |
type | InterpolationType | Jenis interpolasi minpoint yang akan ditetapkan. |
value | String | Nilai minpoint yang akan ditetapkan. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setItalic(italic)
Menyetel teks miring untuk format aturan format bersyarat. Jika italic
adalah true
,
aturan akan mencetak miring teks jika kondisinya terpenuhi; jika false
, aturan akan menghapus
miring yang ada jika kondisi terpenuhi. Meneruskan null
akan menghapus setelan format miring dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
italic | Boolean | Apakah teks harus dicetak miring atau tidak jika kondisi format terpenuhi;
null akan menghapus setelan ini. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setRanges(ranges)
Menetapkan satu atau beberapa rentang tempat aturan format bersyarat ini diterapkan. Operasi ini mengganti rentang yang ada. Menyetel array kosong akan menghapus semua rentang yang ada. Aturan harus memiliki minimal satu rentang.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
ranges | Range[] | Rentang tempat aturan format bersyarat ini diterapkan. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setStrikethrough(strikethrough)
Menetapkan teks yang dicoret untuk format aturan format bersyarat. Jika strikethrough
adalah
true
, aturan akan mencoret teks jika kondisinya terpenuhi; jika false
, aturan
akan menghapus pemformatan yang dicoret yang ada jika kondisi terpenuhi. Meneruskan null
akan menghapus setelan format coret dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
strikethrough | Boolean | Apakah teks harus dicoret atau tidak jika kondisi format
terpenuhi; null akan menghapus setelan ini. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
setUnderline(underline)
Menetapkan teks yang digarisbawahi untuk format aturan format bersyarat. Jika underline
adalah true
, aturan akan menggarisbawahi teks jika kondisi terpenuhi; jika false
, aturan akan menghapus
garis bawah yang ada jika kondisi terpenuhi. Meneruskan null
akan menghapus setelan format garis bawah dari aturan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
underline | Boolean | Apakah teks harus digarisbawahi jika kondisi format terpenuhi;
null menghapus setelan ini. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenCellEmpty()
Menetapkan aturan format bersyarat yang akan dipicu saat sel kosong.
// 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);
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenCellNotEmpty()
Menetapkan aturan format bersyarat yang akan dipicu saat sel tidak kosong.
// 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);
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenDateAfter(date)
Menetapkan aturan format bersyarat yang akan dipicu jika tanggal setelah nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Tanggal terakhir. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenDateAfter(date)
Menetapkan aturan format bersyarat yang akan dipicu jika tanggal melebihi tanggal relatif yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | RelativeDate | Tanggal terakhir relatif terhadap jenis tanggal yang dipilih. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenDateBefore(date)
Menetapkan aturan format bersyarat yang akan dipicu jika tanggal sebelum tanggal yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Tanggal paling awal yang tidak dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenDateBefore(date)
Menetapkan aturan format bersyarat yang akan dipicu jika tanggal lebih awal dari tanggal relatif yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | RelativeDate | Tanggal terakhir relatif terhadap jenis tanggal yang dipilih. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenDateEqualTo(date)
Menetapkan aturan format bersyarat yang akan dipicu saat tanggal sama dengan tanggal yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Satu-satunya tanggal yang dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenDateEqualTo(date)
Menetapkan aturan format bersyarat yang akan dipicu jika suatu tanggal sama dengan tanggal relatif yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | RelativeDate | Tanggal terakhir relatif terhadap jenis tanggal yang dipilih. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenFormulaSatisfied(formula)
Menetapkan aturan format bersyarat yang akan dipicu saat formula yang ditentukan bernilai 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
formula | String | Formula kustom yang bernilai true jika inputnya valid. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberBetween(start, end)
Menetapkan aturan format bersyarat yang akan dipicu ketika suatu angka berada di antara, atau salah satu dari, dua nilai yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
start | Number | Nilai terendah yang dapat diterima. |
end | Number | Nilai tertinggi yang dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberEqualTo(number)
Menetapkan aturan format bersyarat yang akan dipicu saat suatu angka sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Satu-satunya nilai yang dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberGreaterThan(number)
Menetapkan aturan format bersyarat yang akan dipicu saat angka lebih besar dari nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai tertinggi yang tidak dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberGreaterThanOrEqualTo(number)
Menetapkan aturan format bersyarat yang akan dipicu saat suatu angka lebih besar dari atau sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai terendah yang dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberLessThan(number)
Menetapkan aturan format bersyarat untuk dipicu ketika angka lebih kecil dari nilai yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai terendah yang tidak dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberLessThanOrEqualTo(number)
Menetapkan aturan format bersyarat yang akan dipicu jika suatu angka kurang dari atau sama dengan nilai yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai tertinggi yang dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberNotBetween(start, end)
Menetapkan aturan format bersyarat untuk dipicu ketika suatu angka tidak berada di antara, dan bukan dari, dua nilai yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
start | Number | Nilai terendah yang tidak dapat diterima. |
end | Number | Nilai tertinggi yang tidak dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenNumberNotEqualTo(number)
Menetapkan aturan format bersyarat yang akan dipicu saat suatu angka tidak sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Satu-satunya nilai yang tidak dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenTextContains(text)
Menetapkan aturan format bersyarat yang akan dipicu jika input berisi nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Nilai yang harus dimuat oleh input. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenTextDoesNotContain(text)
Menetapkan aturan format bersyarat yang akan dipicu jika input tersebut tidak berisi nilai yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Nilai yang tidak boleh diisi oleh input. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenTextEndsWith(text)
Menetapkan aturan format bersyarat yang akan dipicu saat input diakhiri dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Teks untuk dibandingkan dengan akhir string. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenTextEqualTo(text)
Menetapkan aturan format bersyarat yang akan dipicu jika input tersebut sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Satu-satunya nilai yang dapat diterima. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
whenTextStartsWith(text)
Menetapkan aturan format bersyarat yang akan dipicu saat input tersebut dimulai dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Teks untuk dibandingkan dengan awal string. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai
withCriteria(criteria, args)
Menetapkan aturan format bersyarat ke kriteria yang ditentukan oleh nilai BooleanCriteria
, biasanya diambil dari criteria
dan arguments
aturan yang sudah ada.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
criteria | BooleanCriteria | Jenis kriteria format bersyarat. |
args | Object[] | Array argumen yang sesuai dengan jenis kriteria tersebut; jumlah argumen dan
jenisnya cocok dengan metode when...() yang sesuai di atas. |
Return
ConditionalFormatRuleBuilder
— builder untuk membuat rantai