Class ConditionalFormatRule

AturanFormatBersyarat

Mengakses aturan format bersyarat. Untuk membuat aturan baru, gunakan SpreadsheetApp.newConditionalFormatRule() dan ConditionalFormatRuleBuilder. Anda dapat menggunakan Sheet.setConditionalFormatRules(rules) untuk menetapkan aturan untuk sheet tertentu.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
copy()ConditionalFormatRuleBuilderMenampilkan preset pembuat aturan dengan setelan aturan ini.
getBooleanCondition()BooleanCondition|nullMengambil informasi BooleanCondition aturan jika aturan ini menggunakan kriteria kondisi boolean.
getGradientCondition()GradientCondition|nullMengambil informasi GradientCondition aturan, jika aturan ini menggunakan kriteria kondisi gradien.
getRanges()Range[]Mengambil rentang tempat aturan format bersyarat ini diterapkan.

Dokumentasi mendetail

copy()

Menampilkan preset pembuat aturan dengan setelan aturan ini.

Pulang pergi

ConditionalFormatRuleBuilder — Builder berdasarkan setelan aturan ini.

getBooleanCondition()

Mengambil informasi BooleanCondition aturan jika aturan ini menggunakan kriteria kondisi boolean. Jika tidak, hasil yang ditampilkan adalah null. 

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Pulang pergi

BooleanCondition|null — 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, hasil yang ditampilkan adalah null. 

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

Pulang pergi

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

Pulang pergi

Range[] — Rentang tempat aturan format bersyarat ini diterapkan.