Class ConditionalFormatRule

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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
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[] - النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.