Class ConditionalFormatRule

KoşulluBiçimlendirmeKuralı

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.

Boole koşulu ölçütlerini kullanan kurallar için getBooleanCondition() çağrısı yaparak ve döndürülen BooleanCondition nesnesindeki yöntemleri kullanarak biçimlendirme ayarlarına erişebilirsiniz.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
copy()	ConditionalFormatRuleBuilder	Bu kuralın ayarlarını içeren bir kural oluşturucu hazır ayarı döndürür.
getBooleanCondition()	BooleanCondition|null	Bu kuralda boole koşulu ölçütleri kullanılıyorsa kuralın BooleanCondition bilgilerini alır.
getGradientCondition()	GradientCondition|null	Bu 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 kuralda boole koşulu ölçütleri kullanılıyorsa kuralın BooleanCondition bilgilerini alır. Aksi takdirde null değerini döndürür. Boole koşulları, yazı tipi ağırlığı, yazı tipi rengi ve arka plan rengi gibi biçimlendirme ayarlarını içerir.

// 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|null: 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|null: 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.