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