Class ConditionalFormatRule

ConditionalFormatRule

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

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
copy()ConditionalFormatRuleBuilderMenampilkan preset pembuat aturan dengan setelan aturan ini.
getBooleanCondition()BooleanConditionMengambil informasi BooleanCondition aturan jika aturan ini menggunakan kriteria kondisi boolean.
getGradientCondition()GradientConditionMengambil 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.

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.