Class ConditionalFormatRule

قاعدةالتنسيقالشرطي

الوصول إلى قواعد التنسيق الشرطي لإنشاء قاعدة جديدة، استخدِم SpreadsheetApp.newConditionalFormatRule() وConditionalFormatRuleBuilder. يمكنك استخدام Sheet.setConditionalFormatRules(rules) لضبط القواعد لجدول بيانات معيّن.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
copy()	ConditionalFormatRuleBuilder	تعرِض هذه السمة إعدادات مُعدّة مسبقًا لصانع القواعد باستخدام إعدادات هذه القاعدة.
getBooleanCondition()	BooleanCondition	يسترجع معلومات BooleanCondition للقاعدة إذا كانت هذه القاعدة تستخدِم معايير شرط منطقي.
getGradientCondition()	GradientCondition	يسترجع معلومات GradientCondition للقاعدة، إذا كانت هذه القاعدة تستخدِم معايير حالة متدرّجة.
getRanges()	Range[]	يسترجع النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.

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

copy()

تعرِض هذه السمة إعدادات مُعدّة مسبقًا لصانع القواعد باستخدام إعدادات هذه القاعدة.

الإرجاع

ConditionalFormatRuleBuilder: أداة إنشاء مستندة إلى إعدادات هذه القاعدة

---

getBooleanCondition()

يسترجع معلومات BooleanCondition للقاعدة إذا كانت هذه القاعدة تستخدِم معايير شرط منطقي. بخلاف ذلك، يتم عرض 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());
}

الإرجاع

BooleanCondition: عنصر الشرط المنطقي، أو null إذا كانت القاعدة لا تستخدم شرطًا منطقيًا

---

getGradientCondition()

يسترجع معلومات GradientCondition للقاعدة، إذا كانت هذه القاعدة تستخدِم معايير حالة متدرّجة. بخلاف ذلك، يتم عرض 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());
}

الإرجاع

GradientCondition: عنصر شرط التدرّج، أو null إذا كانت القاعدة لا تستخدِم شرط التدرّج

---

getRanges()

يسترجع النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.

// 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[]: النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها