ConditionalFormatRules içindeki Boole koşullarına erişme Her koşullu biçimlendirme kuralı tek bir mantıksal koşul içerebilir. Boole koşulunun kendisi, bir Boole ölçütü (değerlerle) ve biçimlendirme ayarları içerir. Ölçütler, bir hücrenin içeriğine göre değerlendirilir ve true veya false değeri döndürülür. Ölçütler true olarak değerlendirilirse koşulun biçimlendirme ayarları hücreye uygulanır.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
getBackgroundObject() | Color | Bu boole koşulunun arka plan rengini alır. |
getBold() | Boolean | Bu boole koşulu metni kalınlaştırırsa true değerini, metindeki kalınlığı kaldırırsa false değerini döndürür. |
getCriteriaType() | BooleanCriteria | Kuralın ölçüt türünü BooleanCriteria enum'unda tanımlandığı şekilde alır. |
getCriteriaValues() | Object[] | Kuralın ölçütleri için bir bağımsız değişken dizisi alır. |
getFontColorObject() | Color | Bu boole koşulunun yazı tipi rengini alır. |
getItalic() | Boolean | Bu Boole koşulu metni italikleştiriyorsa true, metindeki italik biçimi kaldırıyorsa false değerini döndürür. |
getStrikethrough() | Boolean | Bu boole koşulu metnin üzerini çiziyorsa true değerini, metnin üzerindeki çizmeyi kaldırıyorsa false değerini döndürür. |
getUnderline() | Boolean | Bu boole koşulu metnin altını çiziyorsa true değerini, metnin altını çizmeyi kaldırıyorsa false değerini döndürür. |
Ayrıntılı dokümanlar
getBackgroundObject()
Bu boole koşulunun arka plan rengini alır. Ayarlanmamışsa null değerini döndürür.
// Logs the boolean condition background color for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
const color = rule.getBooleanCondition().getBackgroundObject();
Logger.log(`Background color: ${color.asRgbColor().asHexString()}`);
}
Return
Color: Arka plan rengi veya bu koşul için ayarlanmamışsa null.
getBold()
Bu boole koşulu metni kalınlaştırırsa true değerini, metindeki kalınlığı kaldırırsa false değerini döndürür. Kalınlık etkilenmezse null döndürülür.
// Logs the boolean condition font weight for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
const bold = rule.getBooleanCondition().getBold();
Logger.log(`Bold: ${bold}`);
}
Return
Boolean: Boole koşulunun metni kalınlaştırıp kalınlaştırmadığını belirtir veya kalınlaştırmadan etkilenmiyorsa null değerini alır.
getCriteriaType()
Kuralın ölçüt türünü BooleanCriteria enum'unda tanımlandığı şekilde alır. Ölçütlerin bağımsız değişkenlerini almak için getCriteriaValues() değerini kullanın. Koşullu biçimlendirme kuralı oluşturmak veya mevcut bir kuralı değiştirmek için bu değerleri kullanmak istiyorsanız ConditionalFormatRuleBuilder.withCriteria(criteria, args) bölümüne bakın.
// Log information about the conditional formats on the active sheet that use
// boolean conditions.
const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
const booleanCondition = format.getBooleanCondition();
if (booleanCondition) {
const criteria = booleanCondition.getCriteriaType();
const args = booleanCondition.getCriteriaValues();
Logger.log(`The conditional format rule is ${criteria} ${args}`);
}
});
Return
BooleanCriteria: Koşullu biçimlendirme ölçütlerinin türü.
getCriteriaValues()
Kuralın ölçütleri için bir bağımsız değişken dizisi alır. Ölçüt türünü almak için getCriteriaType() değerini kullanın. Koşullu biçimlendirme kuralı oluşturmak veya mevcut bir kuralı değiştirmek için bu değerleri kullanmak istiyorsanız ConditionalFormatRuleBuilder.withCriteria(criteria, args) bölümüne bakın.
// Log information about the conditional formats on the active sheet that use
// boolean conditions.
const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
const booleanCondition = format.getBooleanCondition();
if (booleanCondition) {
const criteria = booleanCondition.getCriteriaType();
const args = booleanCondition.getCriteriaValues();
Logger.log(`The conditional format rule is ${criteria} ${args}`);
}
});
Return
Object[]: Kuralın ölçüt türüne uygun bir bağımsız değişken dizisidir. Bağımsız değişkenlerin sayısı ve türleri, ConditionalFormatRuleBuilder sınıfının ilgili when...() yöntemiyle eşleşir.
getFontColorObject()
Bu boole koşulunun yazı tipi rengini alır. Ayarlanmamışsa null değerini döndürür.
// Logs the boolean condition font color for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
const color = rule.getBooleanCondition().getFontColorObject();
Logger.log(`Font color: ${color.asRgbColor().asHexString()}`);
}
Return
Color: Yazı tipi rengi veya bu koşul için ayarlanmamışsa null.
getItalic()
Bu Boole koşulu metni italikleştiriyorsa true, metindeki italik biçimi kaldırıyorsa false değerini döndürür. İtalik etkilenmemişse null değerini döndürür.
// Logs the boolean condition font style for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
const italic = rule.getBooleanCondition().getItalic();
Logger.log(`Italic: ${italic}`);
}
Return
Boolean: Boole koşulunun metni italikleştirip italikleştirmeyeceğini belirtir. İtalikleştirmeden etkilenmiyorsa null değerini alır.
getStrikethrough()
Bu boole koşulu metnin üzerini çiziyorsa true değerini, metnin üzerindeki çiziği kaldırıyorsa false değerini döndürür. Üst çizgi etkilenmezse null döndürür.
// Logs the boolean condition strikethrough setting for each conditional format
// rule on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
const strikethrough = rule.getBooleanCondition().getStrikethrough();
Logger.log(`Strikethrough: ${strikethrough}`);
}
Return
Boolean: Boole koşulunun metnin üzerini çizip çizmeyeceği veya üzerinin çizilmesinin etkilenmediği durumlarda null
getUnderline()
Bu boole koşulu metnin altını çiziyorsa true değerini, metnin altını çizmeyi kaldırıyorsa false değerini döndürür. Alt çizgi etkilenmezse null döndürülür.
// Logs the boolean condition underline setting for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
const underline = rule.getBooleanCondition().getUnderline();
Logger.log(`Underline: ${underline}`);
}
Return
Boolean: Boole koşulunun metnin altını çizip çizmeyeceğini belirtir. Altı çizilinull