Class ConditionalFormatRule

KoşulluBiçimKuralı

Koşullu biçimlendirme kurallarına erişme. Yeni kural oluşturmak için SpreadsheetApp.newConditionalFormatRule() ve ConditionalFormatRuleBuilder simgesini kullanın. Belirli bir sayfanın kurallarını ayarlamak için Sheet.setConditionalFormatRules(rules)'ü kullanabilirsiniz.

Yöntemler

YöntemDönüş türüKısa açıklama
copy()ConditionalFormatRuleBuilderBu kuralın ayarlarını içeren bir kural oluşturucu hazır ayarı döndürür.
getBooleanCondition()BooleanConditionBu kural mantıksal koşul ölçütleri kullanıyorsa kuralın BooleanCondition bilgilerini alır.
getGradientCondition()GradientConditionBu kural gradyan koşul ölçütlerini kullanıyorsa kuralın GradientCondition bilgilerini alır.
getRanges()Range[]Bu koşullu biçimlendirme kuralının uygulandığı aralıkları alır.

Ayrıntılı dokümanlar

copy()

Bu kuralın ayarlarını içeren bir kural oluşturucu hazır ayarı döndürür.

Return

ConditionalFormatRuleBuilder: Bu kuralın ayarlarına dayalı bir oluşturucu


getBooleanCondition()

Bu kural mantıksal koşul ölçütleri kullanıyorsa kuralın BooleanCondition bilgilerini alır. Aksi takdirde null döndürülür.

// 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());
}

Return

BooleanCondition: Boole koşulu nesnesi veya kuralda boole koşulu kullanılmıyorsa null.


getGradientCondition()

Bu kural gradyan koşul ölçütlerini kullanıyorsa kuralın GradientCondition bilgilerini alır. Aksi takdirde null döndürülür.

// 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());
}

Return

GradientCondition: Gradyan koşulu nesnesi veya kuralda gradyan koşulu kullanılmıyorsa null.


getRanges()

Bu koşullu biçimlendirme kuralının uygulandığı aralıkları alır.

// 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());
}

Return

Range[]: Bu koşullu biçimlendirme kuralının uygulandığı aralıklar.