يمكنك الوصول إلى الشروط المنطقية في Conditional
. قد تحتوي كل قاعدة
تنسيق مشروط على شرط منطقي واحد. يحتوي الشرط المنطقي نفسه
على معايير منطقية (مع القيم) وإعدادات التنسيق. يتم تقييم المعايير مقارنةً بمحتويات خلية، ما يؤدي إلى ظهور قيمة true
أو false
. إذا كانت قيمة
المعايير هي true
، يتم تطبيق إعدادات تنسيق الشرط على الخلية.
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
get | Color | تحصل على لون الخلفية لهذا الشرط المنطقي. |
get | Boolean | تعرِض true إذا كان هذا الشرط المنطقي يُبرز النص، وتعرِض false إذا كان هذا
الشرط المنطقي يزيل التشديد من النص. |
get | Boolean | تحصل على نوع معايير القاعدة كما هو محدّد في التعداد Boolean . |
get | Object[] | تحصل على صفيف من الوسيطات لمعايير القاعدة. |
get | Color | تحصل على لون الخط لهذا الشرط المنطقي. |
get | Boolean | تعرِض هذه الدالة القيمة true إذا كان هذا الشرط المنطقي يُكتب النص بخط مائل، وتعرِض القيمة false إذا كان
هذا الشرط المنطقي يزيل الخط المائل من النص. |
get | Boolean | تعرِض true إذا كان هذا الشرط المنطقي يُشطب على النص، وتعرِض false إذا كان هذا الشرط المنطقي يزيل الشطب من النص. |
get | Boolean | تعرِض هذه الدالة القيمة true إذا كان هذا الشرط المنطقي يضع خطًا تحت النص، وتعرِض القيمة false إذا كان
هذا الشرط المنطقي يزيل الخطّ تحت النص. |
مستندات تفصيلية
get Background Object()
تحصل على لون الخلفية لهذا الشرط المنطقي. يتم عرض القيمة 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
في حال عدم ضبطه لهذا الشرط
get Bold()
تعرِض 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
إذا لم يكن هناك تأثير
في الكتابة بالخط العريض
get Criteria Type()
تحصل على نوع معايير القاعدة كما هو محدّد في التعداد Boolean
. للحصول على
المَعلمات للمعايير، استخدِم get
. لاستخدام هذه القيم لإنشاء قاعدة تنسيق مشروط أو
تعديلها، اطّلِع على Conditional
.
// 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}`); } });
الإرجاع
Boolean
: نوع معايير التنسيق الشرطي.
get Criteria Values()
تحصل على صفيف من الوسيطات لمعايير القاعدة. للحصول على نوع المعايير، استخدِم get
. لاستخدام هذه القيم لإنشاء قاعدة تنسيق مشروط أو تعديلها، اطّلِع على
Conditional
.
// 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...()
المقابلة لفئة Conditional
.
get Font Color Object()
تحصل على لون الخط لهذا الشرط المنطقي. يتم عرض القيمة 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
في حال عدم ضبطه لهذا الشرط
get Italic()
تعرِض هذه الدالة القيمة 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
إذا
لم يتأثّر النص بالخط المائل
get Strikethrough()
تعرِض 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
إذا كان
الخط المتوسط لا يتأثر
get Underline()
تعرِض هذه الدالة القيمة 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
إذا
لم يتأثّر النص بالخط السفلي