Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

Koşullu biçim kuralları için oluşturucu.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Yöntemler

YöntemDönüş türüKısa açıklama
build()ConditionalFormatRuleOluşturucuya uygulanan ayarlardan bir koşullu biçimlendirme kuralı oluşturur.
copy()ConditionalFormatRuleBuilderBu kuralın ayarlarıyla kural oluşturucu hazır ayarı döndürür.
getBooleanCondition()BooleanConditionBu kural, boole koşulu ölçütlerini 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ı getirir.
setBackground(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için arka plan rengini ayarlar.
setBackgroundObject(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için arka plan rengini ayarlar.
setBold(bold)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için metin kalınlığını ayarlar.
setFontColor(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için yazı tipi rengini ayarlar.
setFontColorObject(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için yazı tipi rengini ayarlar.
setGradientMaxpoint(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının renk geçişi maksimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki maksimum değeri kullanır.
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının renk geçişi maksimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki maksimum değeri kullanır.
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının renk geçişi maksimum noktası alanlarını ayarlar.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının renk geçişi maksimum noktası alanlarını ayarlar.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının renk geçişi orta nokta alanlarını ayarlar.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının renk geçişi orta nokta alanlarını ayarlar.
setGradientMinpoint(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının gradyan minimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki minimum değeri kullanır.
setGradientMinpointObject(color)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının gradyan minimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki minimum değeri kullanır.
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının gradyan minimum noktası alanlarını ayarlar.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının gradyan minimum noktası alanlarını ayarlar.
setItalic(italic)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için metni italik yapar.
setRanges(ranges)ConditionalFormatRuleBuilderBu koşullu biçimlendirme kuralının uygulandığı bir veya daha fazla aralığı ayarlar.
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için metnin üstü çizilmesini ayarlar.
setUnderline(underline)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralının biçimi için metnin altının çizilmesini ayarlar.
whenCellEmpty()ConditionalFormatRuleBuilderHücre boş olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenCellNotEmpty()ConditionalFormatRuleBuilderHücre boş olmadığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenDateAfter(date)ConditionalFormatRuleBuilderBir tarih verilen değerden sonra olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenDateAfter(date)ConditionalFormatRuleBuilderBir tarih, belirtilen göreli tarihten sonra olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenDateBefore(date)ConditionalFormatRuleBuilderBir tarih, belirtilen tarihten önce olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenDateBefore(date)ConditionalFormatRuleBuilderBir tarih, belirtilen göreli tarihten önce olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenDateEqualTo(date)ConditionalFormatRuleBuilderBir tarih, belirtilen tarihe eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenDateEqualTo(date)ConditionalFormatRuleBuilderBir tarih, belirtilen göreli tarihe eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderBelirtilen formül true olarak değerlendirildiğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderBir sayı, belirtilen iki değer arasında veya bu değerlerden biri olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberEqualTo(number)ConditionalFormatRuleBuilderBir sayı verilen değere eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderBir sayı verilen değerden büyük olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderBir sayı belirtilen değerden büyük veya bu değere eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberLessThan(number)ConditionalFormatRuleBuilderVerilen değerden küçük bir sayı olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderVerilen değere eşit veya daha küçük bir sayı olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderBir sayı, belirtilen iki değer arasında olmadığında ve iki değerde de olmadığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderBir sayı verilen değere eşit olmadığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenTextContains(text)ConditionalFormatRuleBuilderGiriş, verilen değeri içerdiğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderGiriş, belirtilen değeri içermediğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenTextEndsWith(text)ConditionalFormatRuleBuilderGiriş, verilen değerle bittiğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenTextEqualTo(text)ConditionalFormatRuleBuilderGiriş, verilen değere eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.
whenTextStartsWith(text)ConditionalFormatRuleBuilderGiriş verilen değerle başladığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.
withCriteria(criteria, args)ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralını, genellikle mevcut bir kuralın criteria ve arguments değerlerinden alınan BooleanCriteria değerleriyle tanımlanan ölçütlere ayarlar.

Ayrıntılı belgeler

build()

Oluşturucuya uygulanan ayarlardan bir koşullu biçimlendirme kuralı oluşturur.

Return

ConditionalFormatRule: Koşullu biçimlendirme kuralının temsili


copy()

Bu kuralın ayarlarıyla 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çütlerini 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Return

BooleanCondition — Boole koşul nesnesi veya kural bir boole koşulu kullanmıyorsa null.


getGradientCondition()

Bu kural gradyan koşul ö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.
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: Gradyan koşulu nesnesi veya kural bir gradyan koşulu kullanmıyorsa null.


getRanges()

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

// 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[] — bu koşullu biçimlendirme kuralının uygulandığı aralıklar.


setBackground(color)

Koşullu biçimlendirme kuralının biçimi için arka plan rengini ayarlar. null öğesini geçirmek, arka plan renk biçimi ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorStringTemizlenmesi istenen renk veya null.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setBackgroundObject(color)

Koşullu biçimlendirme kuralının biçimi için arka plan rengini ayarlar. null öğesini geçirmek, arka plan renk biçimi ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to theme background color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorColorTemizlenmesi istenen renk nesnesi veya null.

Return

ConditionalFormatRuleBuilder: Zincirleme için oluşturucu.


setBold(bold)

Koşullu biçimlendirme kuralının biçimi için metin kalınlığını ayarlar. bold değeri true ise koşul karşılanırsa kural metni kalın harflerle gösterir. false değerine ayarlanırsa kural, koşul karşılanırsa mevcut kalın yazıları kaldırır. null değerini geçirmek, kalın biçimi ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text bold if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
boldBooleanBiçim koşulu karşılanırsa metnin kalın yapılıp yapılmayacağı; null bu ayarı kaldırır.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setFontColor(color)

Koşullu biçimlendirme kuralının biçimi için yazı tipi rengini ayarlar. null değerini geçirmek, yazı tipi rengi biçimi ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorStringTemizlenmesi istenen renk veya null.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setFontColorObject(color)

Koşullu biçimlendirme kuralının biçimi için yazı tipi rengini ayarlar. null değerini geçirmek, yazı tipi rengi biçimi ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to theme text color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorColorTemizlenmesi istenen renk nesnesi veya null.

Return

ConditionalFormatRuleBuilder: Zincirleme için oluşturucu.


setGradientMaxpoint(color)

Koşullu biçimlendirme kuralının renk geçişi maksimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki maksimum değeri kullanır. Ayrıca, renk geçişinin maksimum nokta rengini giriş rengine ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorStringAyarlanacak maksimum nokta rengi.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setGradientMaxpointObject(color)

Koşullu biçimlendirme kuralının renk geçişi maksimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki maksimum değeri kullanır. Ayrıca, renk geçişinin maksimum nokta rengini giriş rengine ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorColorAyarlanacak maksimum nokta renk nesnesi.

Return

ConditionalFormatRuleBuilder: Zincirleme için oluşturucu.


setGradientMaxpointObjectWithValue(color, type, value)

Koşullu biçimlendirme kuralının renk geçişi maksimum noktası alanlarını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their
// values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorColorAyarlanacak maksimum nokta rengi.
typeInterpolationTypeAyarlanacak maksimum nokta interpolasyonu türü.
valueStringAyarlanacak maksimum puan değeri.

Return

ConditionalFormatRuleBuilder: Zincirleme için oluşturucu.


setGradientMaxpointWithValue(color, type, value)

Koşullu biçimlendirme kuralının renk geçişi maksimum noktası alanlarını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorStringAyarlanacak maksimum nokta rengi.
typeInterpolationTypeAyarlanacak maksimum nokta interpolasyonu türü.
valueStringAyarlanacak maksimum puan değeri.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setGradientMidpointObjectWithValue(color, type, value)

Koşullu biçimlendirme kuralının renk geçişi orta nokta alanlarını ayarlar. İnterpolasyon türünde geçirilen null ise tüm orta nokta alanlarını temizler.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorColorAyarlanacak orta nokta rengi.
typeInterpolationTypeAyarlanacak orta nokta interpolasyon türü veya temizlenecek null.
valueStringAyarlanacak orta nokta değeri.

Return

ConditionalFormatRuleBuilder: Zincirleme için oluşturucu.


setGradientMidpointWithValue(color, type, value)

Koşullu biçimlendirme kuralının renk geçişi orta nokta alanlarını ayarlar. İnterpolasyon türünde geçirilen null ise tüm orta nokta alanlarını temizler.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorStringAyarlanacak orta nokta rengi.
typeInterpolationTypeAyarlanacak orta nokta interpolasyon türü veya temizlenecek null.
valueStringAyarlanacak orta nokta değeri.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setGradientMinpoint(color)

Koşullu biçimlendirme kuralının gradyan minimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki minimum değeri kullanır. Ayrıca, renk geçişinin minimum nokta rengini giriş rengine ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorStringAyarlanacak minimum nokta rengi.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setGradientMinpointObject(color)

Koşullu biçimlendirme kuralının gradyan minimum noktası değerini temizler ve bunun yerine kuralın aralıklarındaki minimum değeri kullanır. Ayrıca, renk geçişinin minimum nokta rengini giriş rengine ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorColorAyarlanacak minimum nokta renk nesnesi.

Return

ConditionalFormatRuleBuilder: Zincirleme için oluşturucu.


setGradientMinpointObjectWithValue(color, type, value)

Koşullu biçimlendirme kuralının gradyan minimum noktası alanlarını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorColorAyarlanacak minimum nokta rengi.
typeInterpolationTypeAyarlanacak minimum nokta interpolasyon türü.
valueStringAyarlanacak minimum nokta değeri.

Return

ConditionalFormatRuleBuilder: Zincirleme için oluşturucu.


setGradientMinpointWithValue(color, type, value)

Koşullu biçimlendirme kuralının gradyan minimum noktası alanlarını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red to green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
colorStringAyarlanacak minimum nokta rengi.
typeInterpolationTypeAyarlanacak minimum nokta interpolasyon türü.
valueStringAyarlanacak minimum nokta değeri.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setItalic(italic)

Koşullu biçimlendirme kuralının biçimi için metni italik yapar. italic değeri true ise koşul karşılanırsa kural metni italik yapar. false ise kural, koşul karşılanırsa mevcut italik yazı tipini kaldırır. null geçişi, italik biçim ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text italic if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setItalic(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
italicBooleanBiçim koşulu karşılanırsa metnin italik yapılıp yapılmayacağı; null bu ayarı kaldırır.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setRanges(ranges)

Bu koşullu biçimlendirme kuralının uygulandığı bir veya daha fazla aralığı ayarlar. Bu işlem, mevcut aralıkların yerini alır. Boş bir dizi ayarlanırsa mevcut aralıklar temizlenir. Bir kuralın en az bir aralığı olmalıdır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6
// to turn red if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
rangesRange[]Bu koşullu biçimlendirme kuralının uygulandığı aralıklar.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setStrikethrough(strikethrough)

Koşullu biçimlendirme kuralının biçimi için metnin üstü çizilmesini ayarlar. strikethrough değeri true ise koşul karşılanırsa kural metnin üstü çizer. false ise kural, koşul karşılanırsa mevcut üstü çizili biçimlendirmeyi kaldırır. null özelliğini geçirmek, üstü çizili biçim ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setStrikethrough(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
strikethroughBooleanBiçim koşulu karşılanırsa metnin üstü çizili yapılıp yapılmayacağı; null bu ayarı kaldırır.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


setUnderline(underline)

Koşullu biçimlendirme kuralının biçimi için metnin altının çizilmesini ayarlar. underline değeri true ise kural, koşul karşılanırsa metnin altını çizer. false ise kural, koşul karşılanırsa mevcut tüm alt çizgileri kaldırır. null değerini geçirmek, altı çizili biçim ayarını kuraldan kaldırır.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
underlineBooleanBiçim koşulu karşılanırsa metnin altının çizili olup olmayacağını belirtir; null bu ayarı kaldırır.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenCellEmpty()

Hücre boş olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenCellNotEmpty()

Hücre boş olmadığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are not empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenDateAfter(date)

Bir tarih verilen değerden sonra olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
dateDateEn son tarih.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenDateAfter(date)

Bir tarih, belirtilen göreli tarihten sonra olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
dateRelativeDateSeçilen tarih türüne göre en son tarih.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenDateBefore(date)

Bir tarih, belirtilen tarihten önce olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
dateDateKabul edilemeyen en erken tarih.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenDateBefore(date)

Bir tarih, belirtilen göreli tarihten önce olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
dateRelativeDateSeçilen tarih türüne göre en son tarih.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenDateEqualTo(date)

Bir tarih, belirtilen tarihe eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the date 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
dateDateKabul edilebilir tek tarih.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenDateEqualTo(date)

Bir tarih, belirtilen göreli tarihe eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain todays date.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
dateRelativeDateSeçilen tarih türüne göre en son tarih.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenFormulaSatisfied(formula)

Belirtilen formül true olarak değerlendirildiğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they satisfy the condition "=EQ(B4, C3)".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied("=EQ(B4, C3)")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
formulaStringGiriş geçerliyse true sonucunu veren özel bir formül.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberBetween(start, end)

Bir sayı, belirtilen iki değer arasında veya bu değerlerden biri olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
startNumberKabul edilebilir en düşük değer.
endNumberKabul edilebilir en yüksek değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberEqualTo(number)

Bir sayı verilen değere eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
numberNumberKabul edilebilir tek değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberGreaterThan(number)

Bir sayı verilen değerden büyük olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red
// if they contain a number greater than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
numberNumberKabul edilemez en yüksek değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberGreaterThanOrEqualTo(number)

Bir sayı belirtilen değerden büyük veya bu değere eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number greater than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
numberNumberKabul edilebilir en düşük değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberLessThan(number)

Verilen değerden küçük bir sayı olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
numberNumberKabul edilemez en düşük değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberLessThanOrEqualTo(number)

Verilen değere eşit veya daha küçük bir sayı olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
numberNumberKabul edilebilir en yüksek değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberNotBetween(start, end)

Bir sayı, belirtilen iki değer arasında olmadığında ve iki değerde de olmadığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number not between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
startNumberKabul edilemez en düşük değer.
endNumberKabul edilemez en yüksek değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenNumberNotEqualTo(number)

Bir sayı verilen değere eşit olmadığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
numberNumberKabul edilemez tek değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenTextContains(text)

Giriş, verilen değeri içerdiğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextContains("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
textStringGirişin içermesi gereken değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenTextDoesNotContain(text)

Giriş, belirtilen değeri içermediğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextDoesNotContain("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
textStringGirişin içermemesi gereken değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenTextEndsWith(text)

Giriş, verilen değerle bittiğinde tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they end with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
textStringDizenin sonuyla karşılaştırılacak metin.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenTextEqualTo(text)

Giriş, verilen değere eşit olduğunda tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they have text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
textStringKabul edilebilir tek değer.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


whenTextStartsWith(text)

Giriş verilen değerle başladığında tetiklenecek koşullu biçimlendirme kuralını ayarlar.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they start with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
textStringDizenin başlangıcıyla karşılaştırılacak metin.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu


withCriteria(criteria, args)

Koşullu biçimlendirme kuralını, genellikle mevcut bir kuralın criteria ve arguments değerlerinden alınan BooleanCriteria değerleriyle tanımlanan ölçütlere ayarlar.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
var booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  var rule = SpreadsheetApp.newConditionalFormatRule()
      .withCriteria(booleanCondition.getCriteriaType(),
         booleanCondition.getCriteriaValues())
      .setBackground("#000000")
      .setRanges(rule.getRanges())
      .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

Parametreler

AdTürAçıklama
criteriaBooleanCriteriaKoşullu biçim ölçütlerinin türü.
argsObject[]Ölçüt türüne uygun bağımsız değişken dizisi. Bağımsız değişken sayısı ve türü, yukarıdaki ilgili when...() yöntemiyle eşleşir.

Return

ConditionalFormatRuleBuilder — zincirleme bağlantı için oluşturucu