تمت ترجمة هذه الصفحة بواسطة 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.
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()}`);
}

الإرجاع

Color: لون الخلفية، أو null في حال عدم ضبطه لهذا الشرط

`getBold()`

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

// 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}`);
}

الإرجاع

Boolean - ما إذا كان الشرط المنطقي يُبرز النص بالخط العريض أم لا، أو null إذا لم يكن هناك تأثير في الكتابة بالخط العريض

`getCriteriaType()`

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

// 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}`);
  }
});

الإرجاع

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

`getCriteriaValues()`

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

// 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}`);
  }
});

الإرجاع

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

`getFontColorObject()`

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

// 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()}`);
}

الإرجاع

Color: لون الخط، أو null في حال عدم ضبطه لهذا الشرط

`getItalic()`

تعرِض هذه الدالة القيمة true إذا كان هذا الشرط المنطقي يُكتب النص بخط مائل، وتعرِض القيمة false إذا كان هذا الشرط المنطقي يزيل الخط المائل من النص. تعرِض null إذا كانت الخطوط المائلة غير متأثرة.

// 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}`);
}

الإرجاع

‫Boolean — ما إذا كان الشرط المنطقي يُكتب النص بخط مائل أم لا، أو null إذا لم يتأثّر النص بالخط المائل

`getStrikethrough()`

تعرِض true إذا كان هذا الشرط المنطقي يُشطب على النص، وتعرِض false إذا كان هذا الشرط المنطقي يزيل الشطب من النص. تعرِض القيمة null إذا لم يتأثّر الخط المُمَحوف.

// 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}`);
}

الإرجاع

Boolean — ما إذا كان الشرط المنطقي يتوسط النص بخط أو لا، أو null إذا كان الخط المتوسط لا يتأثر

`getUnderline()`

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

// 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}`);
}

الإرجاع

‫Boolean — ما إذا كان الشرط المنطقي يضع خطًا تحت النص أم لا، أو null إذا لم يتأثّر النص بالخط السفلي

الطرق المتوقّفة

`getBackground()`

تمّ إيقاف هذا العمود نهائيًا. تم استبداله بـ getBackgroundObject()

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

// 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().getBackground();
  Logger.log(`Background color: ${color}`);
}

الإرجاع

String: سلسلة لون الخلفية، أو null في حال عدم ضبطها لهذا الشرط

`getFontColor()`

تمّ إيقاف هذا العمود نهائيًا. تم استبداله بـ getFontColorObject()

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

// 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) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

الإرجاع

String: سلسلة لون الخط، أو null في حال عدم ضبطها لهذا الشرط.