این صفحه به‌وسیله ‏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[] - محدوده هایی که این قانون قالب شرطی برای آنها اعمال می شود.