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