Class ConditionalFormatRule

ConditionalFormatRule

Mengakses aturan format bersyarat. Untuk membuat aturan baru, gunakan SpreadsheetApp.newConditionalFormatRule() dan ConditionalFormatRuleBuilder. Anda dapat menggunakan Sheet.setConditionalFormatRules(rules) untuk menyetel aturan untuk 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.

Pulang pergi

ConditionalFormatRuleBuilder — builder berdasarkan setelan aturan ini


getBooleanCondition()

Mengambil informasi BooleanCondition aturan jika aturan ini menggunakan kriteria kondisi boolean. Jika tidak, menampilkan 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());
}

Pulang pergi

BooleanCondition — objek kondisi boolean, atau null jika aturan tidak menggunakan boolean .


getGradientCondition()

Mengambil informasi GradientCondition aturan, jika aturan ini menggunakan kriteria kondisi gradien. Jika tidak, menampilkan 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());
}

Pulang pergi

GradientCondition — Objek kondisi gradien, atau null jika aturan tidak menggunakan 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());
}

Pulang pergi

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