Mengakses kondisi boolean di ConditionalFormatRules
. Setiap
aturan format bersyarat dapat berisi satu kondisi boolean. Kondisi boolean itu sendiri
berisi kriteria boolean (dengan nilai) dan setelan pemformatan. Kriteria dievaluasi
terhadap konten sel yang menghasilkan nilai true
atau false
. Jika
kriteria bernilai true
, setelan format kondisi akan diterapkan ke sel.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getBackgroundObject() | Color | Mendapatkan warna latar belakang untuk kondisi boolean ini. |
getBold() | Boolean | Menampilkan true jika kondisi boolean ini menebalkan teks dan menampilkan false jika
kondisi boolean ini menghapus penebalan dari teks. |
getCriteriaType() | BooleanCriteria | Mendapatkan jenis kriteria aturan seperti yang ditentukan dalam enum BooleanCriteria . |
getCriteriaValues() | Object[] | Mendapatkan array argumen untuk kriteria aturan. |
getFontColorObject() | Color | Mendapatkan warna font untuk kondisi boolean ini. |
getItalic() | Boolean | Menampilkan true jika kondisi boolean ini membuat teks miring dan menampilkan false jika
kondisi boolean ini menghapus teks miring dari teks. |
getStrikethrough() | Boolean | Menampilkan true jika kondisi boolean ini mencoret teks dan menampilkan false jika kondisi boolean ini menghapus coretan dari teks. |
getUnderline() | Boolean | Menampilkan true jika kondisi boolean ini menggarisbawahi teks dan menampilkan false jika
kondisi boolean ini menghapus garis bawah dari teks. |
Dokumentasi mendetail
getBackgroundObject()
Mendapatkan warna latar belakang untuk kondisi boolean ini. Menampilkan null
jika tidak ditetapkan.
// Logs the boolean condition background color for each conditional format rule // on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const color = rule.getBooleanCondition().getBackgroundObject(); Logger.log(`Background color: ${color.asRgbColor().asHexString()}`); }
Pulang pergi
Color
— Warna latar belakang, atau null
jika tidak ditetapkan untuk kondisi ini.
getBold()
Menampilkan true
jika kondisi boolean ini menebalkan teks dan menampilkan false
jika
kondisi boolean ini menghapus penebalan dari teks. Menampilkan null
jika pencetak tebal tidak terpengaruh.
// Logs the boolean condition font weight for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const bold = rule.getBooleanCondition().getBold(); Logger.log(`Bold: ${bold}`); }
Pulang pergi
Boolean
— apakah kondisi boolean menebalkan teks atau tidak, atau null
jika penebalan tidak terpengaruh
getCriteriaType()
Mendapatkan jenis kriteria aturan seperti yang ditentukan dalam enum BooleanCriteria
. Untuk mendapatkan
argumen untuk kriteria, gunakan getCriteriaValues()
. Untuk menggunakan nilai ini guna membuat atau
mengubah aturan pemformatan bersyarat, lihat ConditionalFormatRuleBuilder.withCriteria(criteria, args)
.
// Log information about the conditional formats on the active sheet that use // boolean conditions. const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats(); SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => { const booleanCondition = format.getBooleanCondition(); if (booleanCondition) { const criteria = booleanCondition.getCriteriaType(); const args = booleanCondition.getCriteriaValues(); Logger.log(`The conditional format rule is ${criteria} ${args}`); } });
Pulang pergi
BooleanCriteria
— Jenis kriteria format bersyarat.
getCriteriaValues()
Mendapatkan array argumen untuk kriteria aturan. Untuk mendapatkan jenis kriteria, gunakan getCriteriaType()
. Untuk menggunakan nilai ini guna membuat atau mengubah aturan pemformatan bersyarat, lihat
ConditionalFormatRuleBuilder.withCriteria(criteria, args)
.
// Log information about the conditional formats on the active sheet that use // boolean conditions. const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats(); SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => { const booleanCondition = format.getBooleanCondition(); if (booleanCondition) { const criteria = booleanCondition.getCriteriaType(); const args = booleanCondition.getCriteriaValues(); Logger.log(`The conditional format rule is ${criteria} ${args}`); } });
Pulang pergi
Object[]
— Array argumen yang sesuai dengan jenis kriteria aturan; jumlah argumen
dan jenisnya cocok dengan metode when...()
yang sesuai dari class ConditionalFormatRuleBuilder
.
getFontColorObject()
Mendapatkan warna font untuk kondisi boolean ini. Menampilkan null
jika tidak ditetapkan.
// Logs the boolean condition font color for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const color = rule.getBooleanCondition().getFontColorObject(); Logger.log(`Font color: ${color.asRgbColor().asHexString()}`); }
Pulang pergi
Color
— Warna font, atau null
jika tidak ditetapkan untuk kondisi ini.
getItalic()
Menampilkan true
jika kondisi boolean ini membuat teks miring dan menampilkan false
jika
kondisi boolean ini menghapus teks miring dari teks. Menampilkan null
jika teks miring tidak terpengaruh.
// Logs the boolean condition font style for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const italic = rule.getBooleanCondition().getItalic(); Logger.log(`Italic: ${italic}`); }
Pulang pergi
Boolean
— apakah kondisi boolean menebalkan teks atau tidak, atau null
jika
penebalkan tidak terpengaruh
getStrikethrough()
Menampilkan true
jika kondisi boolean ini mencoret teks dan menampilkan false
jika kondisi boolean ini menghapus coretan dari teks. Menampilkan null
jika
coretan tidak terpengaruh.
// Logs the boolean condition strikethrough setting for each conditional format // rule on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const strikethrough = rule.getBooleanCondition().getStrikethrough(); Logger.log(`Strikethrough: ${strikethrough}`); }
Pulang pergi
Boolean
— apakah kondisi boolean mencoret teks atau tidak, atau null
jika
coretan tidak terpengaruh
getUnderline()
Menampilkan true
jika kondisi boolean ini menggarisbawahi teks dan menampilkan false
jika
kondisi boolean ini menghapus garis bawah dari teks. Menampilkan null
jika garis bawah
tidak terpengaruh.
// Logs the boolean condition underline setting for each conditional format rule // on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const underline = rule.getBooleanCondition().getUnderline(); Logger.log(`Underline: ${underline}`); }
Pulang pergi
Boolean
— apakah kondisi boolean menandai teks atau tidak, atau null
jika
garis bawah tidak terpengaruh