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