الوصول إلى قواعد التنسيق الشرطي لإنشاء قاعدة جديدة، استخدِم 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[]
: النطاقات التي تنطبق عليها قاعدة التنسيق الشرطي هذه.