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