الوصول إلى الشروط المنطقية في 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. 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
إذا
لا يتأثر الخط السفلي