Class BooleanCondition

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 إذا كان هذا الشرط المنطقي يزيل الخطّ تحت النص.

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

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 إذا لم تتأثّر الخطوط تحتية.

// 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 إذا لم يتأثّر النص بالخط السفلي

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