تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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