تمت ترجمة هذه الصفحة بواسطة 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 إذا لم يتم ضبطها لهذا الشرط