الوصول إلى قواعد التنسيق الشرطي لإنشاء قاعدة جديدة، استخدِم Spreadsheet
وConditional
. يمكنك استخدام Sheet.setConditionalFormatRules(rules)
لضبط قواعد جدول بيانات معيّن.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
copy() | Conditional | تعرض هذه الطريقة إعدادًا مُسبقًا لأداة إنشاء القواعد يتضمّن إعدادات هذه القاعدة. |
get | Boolean | يسترد معلومات Boolean الخاصة بالقاعدة إذا كانت هذه القاعدة تستخدم معايير شرطية منطقية. |
get | Gradient | تعرض هذه السمة معلومات Gradient الخاصة بالقاعدة، إذا كانت هذه القاعدة تستخدم معايير شرط التدرّج. |
get | Range[] | تعرض هذه الدالة النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي عليها. |
مستندات مفصّلة
copy()
تعرض هذه الطريقة إعدادًا مُسبقًا لأداة إنشاء القواعد يتضمّن إعدادات هذه القاعدة.
الإرجاع
Conditional
: أداة إنشاء تستند إلى إعدادات هذه القاعدة.
get Boolean Condition()
يسترد معلومات Boolean
الخاصة بالقاعدة إذا كانت هذه القاعدة تستخدم معايير شرطية منطقية. بخلاف ذلك، تعرض null
.
// Log the boolean criteria type of the first conditional format rules of a // sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
الإرجاع
Boolean
: عنصر الشرط المنطقي، أو null
إذا كانت القاعدة لا تستخدم شرطًا منطقيًا.
get Gradient Condition()
تعرض هذه السمة معلومات Gradient
الخاصة بالقاعدة، إذا كانت هذه القاعدة تستخدم معايير شرط التدرّج. بخلاف ذلك، تعرض null
.
// Log the gradient minimum color of the first conditional format rule of a // sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
الإرجاع
Gradient
: عنصر شرط التدرّج أو null
إذا كانت القاعدة لا تستخدم شرط التدرّج
get Ranges()
تعرض هذه الدالة النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي عليها.
// Log each range of the first conditional format rule of a sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const ranges = rule.getRanges(); for (let i = 0; i < ranges.length; i++) { Logger.log(ranges[i].getA1Notation()); }
الإرجاع
Range[]
: النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها