تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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[]: مصفوفة من الوسيطات المناسبة لنوع معايير القاعدة ويتطابق عدد الوسيطات ونوعها مع طريقة 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 إذا لم يتم ضبط هذا الشرط