دسترسی به قوانین قالب بندی شرطی برای ایجاد یک قانون جدید، از 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[]
- محدوده هایی که این قانون قالب شرطی برای آنها اعمال می شود.