Class ConditionalFormatRule

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
شرط الشرط

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

الطُرق

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

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

copy()

لعرض إعدادات مسبقة لإنشاء القواعد باستخدام إعدادات هذه القاعدة.

تذكرة ذهاب وعودة

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


getBooleanCondition()

لاسترداد معلومات BooleanCondition القاعدة إذا كانت هذه القاعدة تستخدم معايير شرطية منطقية. بخلاف ذلك، يتم إرجاع null.

// Log the boolean criteria type of the first conditional format rules of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

تذكرة ذهاب وعودة

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


getGradientCondition()

لاسترداد معلومات GradientCondition\u30s، في حال كانت هذه القاعدة تستخدم معايير شرط التدرج. بخلاف ذلك، يتم إرجاع null.

// Log the gradient minimum color of the first conditional format rule of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

تذكرة ذهاب وعودة

Range[] - النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.