Class ConditionalFormatRule

KoşulluBiçimKuralı

Koşullu biçimlendirme kurallarına erişme Yeni bir kural oluşturmak için SpreadsheetApp.newConditionalFormatRule() ve ConditionalFormatRuleBuilder simgelerini kullanın. Belirli bir sayfanın kurallarını ayarlamak için Sheet.setConditionalFormatRules(rules) simgesini 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, boole koşulu ölçütleri kullanıyorsa kuralın BooleanCondition bilgilerini alır.
getGradientCondition()GradientConditionBu kural, gradyan koşulu ö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ı belgeler

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, boole koşulu ölçütleri kullanıyorsa kuralın BooleanCondition bilgilerini alır. Aksi takdirde null değerini döndürü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şulu ölçütlerini kullanıyorsa kuralın GradientCondition bilgilerini alır. Aksi takdirde null değerini döndürü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şul 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çim kuralının uygulandığı aralıklar.