Class BooleanCondition

شرط منطقي

الوصول إلى الشروط المنطقية في ConditionalFormatRules. قد تحتوي كل قاعدة تنسيق شرطي على شرط منطقي واحد. ويحتوي الشرط المنطقي نفسه على معايير منطقية (مع قيم) وإعدادات تنسيق. يتم تقييم المعايير مقابل محتوى خلية ما يؤدي إلى إما قيمة true أو false. إذا تم تقييم المعايير على true، يتم تطبيق إعدادات تنسيق الشرط' على الخلية.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
getBackgroundObject()	Color	يحصل على لون الخلفية لهذا الشرط المنطقي.
getBold()	Boolean	عرض true إذا كان هذا الشرط المنطقي يعمل على ظهور النص بخط غامق ويعرض false إذا أزال هذا الشرط المنطقي النص الغامق من النص.
getCriteriaType()	BooleanCriteria	تحصل على نوع معايير القاعدة كما هو محدد في تعداد BooleanCriteria.
getCriteriaValues()	Object[]	تحصل على مجموعة من الوسيطات للمعايير الخاصة بالقاعدة.
getFontColorObject()	Color	للحصول على لون الخط لهذا الشرط المنطقي.
getItalic()	Boolean	عرض true إذا كان هذا الشرط المنطقي يعمل على كتابة النص بخط مائل ويعرض false إذا كان هذا الشرط المنطقي يزيل التنسيق "مائل" من النص.
getStrikethrough()	Boolean	عرض true إذا كان هذا الشرط المنطقي يتوسّطه النص ويُعرِض false إذا أزال هذا الشرط المنطقي نصًا يتوسطه خط من النص.
getUnderline()	Boolean	تعرض true إذا كان هذا الشرط المنطقي يُسطّر النص ويعرض false إذا كان هذا الشرط المنطقي يزيل التسطير من النص.

الطرق التي تم إيقافها نهائيًا

الطريقة	نوع الإرجاع	وصف قصير
getBackground()	String	يحصل على سلسلة لون الخلفية لهذه الحالة المنطقية.
getFontColor()	String	يحصل على سلسلة لون الخط لهذا الشرط المنطقي.

المستندات التفصيلية

getBackgroundObject()

يحصل على لون الخلفية لهذا الشرط المنطقي. عرض null إذا لم يتم ضبط السياسة.

// Logs the boolean condition background color for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getBackgroundObject();
  Logger.log("The background color for rule %s is %s", i, color.asRgbColor().asHexString());
}

تذكرة ذهاب وعودة

Color - لون الخلفية أو null إذا لم يتم ضبط هذه الحالة

---

getBold()

عرض true إذا كان هذا الشرط المنطقي يعمل على ظهور النص بخط غامق ويعرض false إذا أزال هذا الشرط المنطقي النص الغامق من النص. يتم عرض null إذا لم يظهر التنسيق "غامق" بنفسك.

// Logs the boolean condition font weight for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var bold = rules[i].getBooleanCondition().getBold();
  Logger.log("The font bold setting for rule %s is %b", i, weight);
}

تذكرة ذهاب وعودة

Boolean — سواء كان الشرط المنطقي يعمل بالخط الغامق أو لا null إذا كان الخط الغامق غير متأثر.

---

getCriteriaType()

تحصل على نوع معايير القاعدة كما هو محدد في تعداد BooleanCriteria. للحصول على وسيطات للمعايير، يمكنك استخدام getCriteriaValues(). لاستخدام هذه القيم لإنشاء قاعدة تنسيق شرطي أو تعديلها، يُرجى الاطّلاع على ConditionalFormatRuleBuilder.withCriteria(criteria, args).

// Log information about the conditional formats on the active sheet that use
// boolean conditions.
var sheet = SpreadsheetApp.getActiveSheet;
var formats = sheet.getConditionalFormats();
sheet.getConditionalFormats().forEach(function(format) {
  var booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    var criteria = booleanCondition.getCriteriaType();
    var args = booleanCondition.getCriteriaValues();
    Logger.log('The conditional format rule is %s %s', criteria, args);
  }
});

تذكرة ذهاب وعودة

BooleanCriteria — نوع معايير التنسيق الشرطي

---

getCriteriaValues()

تحصل على مجموعة من الوسيطات للمعايير الخاصة بالقاعدة. للحصول على نوع المعايير، استخدِم getCriteriaType(). لاستخدام هذه القيم لإنشاء قاعدة تنسيق شرطي أو تعديلها، راجِع ConditionalFormatRuleBuilder.withCriteria(criteria, args).

// Log information about the conditional formats on the active sheet that use
// boolean conditions.
var sheet = SpreadsheetApp.getActiveSheet;
var formats = sheet.getConditionalFormats();
sheet.getConditionalFormats().forEach(function(format) {
  var booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    var criteria = booleanCondition.getCriteriaType();
    var args = booleanCondition.getCriteriaValues();
    Logger.log('The conditional format rule is %s %s', criteria, args);
  }
});

تذكرة ذهاب وعودة

Object[]: مصفوفة من الوسيطات المناسبة لنوع معايير القاعدة&#39؛ وعدد الوسيطات ونوعها يتطابق مع طريقة when...() المقابلة للصف ConditionalFormatRuleBuilder

---

getFontColorObject()

للحصول على لون الخط لهذا الشرط المنطقي. عرض null إذا لم يتم ضبط السياسة.

// Logs the boolean condition font color for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getFontColorObject();
  Logger.log("The font color for rule %s is %s", i, color.asRgbColor().asHexString());
}

تذكرة ذهاب وعودة

Color - لون الخط أو null إذا لم يتم ضبطه لهذا الشرط.

---

getItalic()

عرض true إذا كان هذا الشرط المنطقي يعمل على كتابة النص بخط مائل ويعرض false إذا كان هذا الشرط المنطقي يزيل التنسيق "مائل" من النص. تعرض null إذا كان الخط المائل لم يتأثر.

// Logs the boolean condition font style for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var italic = rules[i].getBooleanCondition().getItalic();
  Logger.log("The font italic setting for rule %s is %b", i, italic);
}

تذكرة ذهاب وعودة

Boolean: سواء كان الشرط المنطقي مائلاً أم لا، أو null إذا لم يكن التنسيق مائلاً

---

getStrikethrough()

عرض true إذا كان هذا الشرط المنطقي يتوسّطه النص ويُعرِض false إذا أزال هذا الشرط المنطقي نصًا يتوسطه خط من النص. تعرض null إذا لم يتأثر النص الذي يتوسطه خط.

// Logs the boolean condition strikethrough setting for each conditional format rule on a
// sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var strikethrough = rules[i].getBooleanCondition().getStrikethrough();
  Logger.log("The font strikethrough setting for rule %s is %b", i, strikethrough);
}

تذكرة ذهاب وعودة

Boolean: سواء كان الشرط المنطقي يُصدِر نصًا أو لا، أو null إذا لم يتأثّر التنسيق "يتوسطه خط"

---

getUnderline()

تعرض true إذا كان هذا الشرط المنطقي يُسطّر النص ويعرض false إذا كان هذا الشرط المنطقي يزيل التسطير من النص. تعرض null إذا لم تحته خط.

// Logs the boolean condition underline setting for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var underline = rules[i].getBooleanCondition().getUnderline();
  Logger.log("The font underline setting for rule %s is %b", i, underline);
}

تذكرة ذهاب وعودة

Boolean: ما إذا كان الشرط المنطقي يُسطّر النص أو null إذا لم يتأثر التنسيق "تسطير"

الطرق التي تم إيقافها نهائيًا

getBackground()

متوقف. تم الاستبدال بـ getBackgroundObject()

يحصل على سلسلة لون الخلفية لهذه الحالة المنطقية. عرض null إذا لم يتم ضبط السياسة.

// Logs the boolean condition background color for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getBackground();
  Logger.log("The background color for rule %s is %s", i, color);
}

تذكرة ذهاب وعودة

String - سلسلة لون الخلفية أو null إذا لم يتم ضبطها لهذا الشرط.

---

getFontColor()

متوقف. تم الاستبدال بـ getFontColorObject()

يحصل على سلسلة لون الخط لهذا الشرط المنطقي. عرض null إذا لم يتم ضبط السياسة.

// Logs the boolean condition font color for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getFontColor();
  Logger.log("The font color for rule %s is %s", i, color);
}

تذكرة ذهاب وعودة

String - سلسلة لون الخط أو null إذا لم يتم ضبطها لهذا الشرط.