این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class ConditionalFormatRuleBuilder

سازنده قوانین قالب مشروط.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

روش ها

روش	نوع برگشت	شرح مختصر
`build()`	`ConditionalFormatRule`	یک قانون قالب شرطی از تنظیمات اعمال شده برای سازنده می سازد.
`copy()`	`ConditionalFormatRuleBuilder`	یک قانون ساز از پیش تنظیم شده را با تنظیمات این قانون برمی گرداند.
`getBooleanCondition()`	`BooleanCondition`	اگر این قانون از معیارهای شرط بولی استفاده کند، اطلاعات `BooleanCondition` قانون را بازیابی می کند.
`getGradientCondition()`	`GradientCondition`	اگر این قانون از معیارهای شرایط گرادیان استفاده کند، اطلاعات `GradientCondition` قانون را بازیابی می کند.
`getRanges()`	`Range[]`	محدوده هایی را که این قانون قالب شرطی برای آنها اعمال می شود، بازیابی می کند.
`setBackground(color)`	`ConditionalFormatRuleBuilder`	رنگ پس زمینه را برای قالب قانون قالب شرطی تنظیم می کند.
`setBackgroundObject(color)`	`ConditionalFormatRuleBuilder`	رنگ پس زمینه را برای قالب قانون قالب شرطی تنظیم می کند.
`setBold(bold)`	`ConditionalFormatRuleBuilder`	متن پررنگ را برای قالب قاعده قالب شرطی تنظیم می کند.
`setFontColor(color)`	`ConditionalFormatRuleBuilder`	رنگ فونت را برای قالب قاعده قالب شرطی تنظیم می کند.
`setFontColorObject(color)`	`ConditionalFormatRuleBuilder`	رنگ فونت را برای قالب قاعده قالب شرطی تنظیم می کند.
`setGradientMaxpoint(color)`	`ConditionalFormatRuleBuilder`	مقدار حداکثر گرادیان قانون قالب شرطی را پاک می کند و در عوض از حداکثر مقدار در محدوده های قانون استفاده می کند.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	مقدار حداکثر گرادیان قانون قالب شرطی را پاک می کند و در عوض از حداکثر مقدار در محدوده های قانون استفاده می کند.
`setGradientMaxpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	فیلدهای ماکزیمم گرادیان قانون قالب شرطی را تنظیم می کند.
`setGradientMaxpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	فیلدهای ماکزیمم گرادیان قانون قالب شرطی را تنظیم می کند.
`setGradientMidpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	فیلدهای نقطه میانی گرادیان قانون قالب شرطی را تنظیم می کند.
`setGradientMidpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	فیلدهای نقطه میانی گرادیان قانون قالب شرطی را تنظیم می کند.
`setGradientMinpoint(color)`	`ConditionalFormatRuleBuilder`	مقدار حداقل گرادیان قانون قالب شرطی را پاک می‌کند و در عوض از حداقل مقدار در محدوده‌های قانون استفاده می‌کند.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	مقدار حداقل گرادیان قانون قالب شرطی را پاک می‌کند و در عوض از حداقل مقدار در محدوده‌های قانون استفاده می‌کند.
`setGradientMinpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	فیلدهای نقطه گرادیان قانون قالب شرطی را تنظیم می کند.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	فیلدهای نقطه گرادیان قانون قالب شرطی را تنظیم می کند.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	حالت مورب متن را برای قالب قاعده قالب شرطی تنظیم می کند.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	یک یا چند محدوده را تنظیم می کند که این قانون قالب شرطی برای آنها اعمال می شود.
`setStrikethrough(strikethrough)`	`ConditionalFormatRuleBuilder`	خط خطی متن را برای قالب قاعده قالب شرطی تنظیم می کند.
`setUnderline(underline)`	`ConditionalFormatRuleBuilder`	زیرخط متن را برای قالب قاعده قالب شرطی تنظیم می کند.
`whenCellEmpty()`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که سلول خالی است راه اندازی شود.
`whenCellNotEmpty()`	`ConditionalFormatRuleBuilder`	قانون قالب مشروط را به گونه ای تنظیم می کند که وقتی سلول خالی نیست راه اندازی شود.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	قاعده قالب شرطی را تنظیم می کند تا زمانی که تاریخ بعد از مقدار داده شده است، راه اندازی شود.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	قاعده قالب شرطی را تنظیم می کند تا زمانی که یک تاریخ بعد از تاریخ نسبی داده شده است، راه اندازی شود.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	قاعده قالب شرطی را تنظیم می کند تا زمانی که تاریخ قبل از تاریخ معین است، راه اندازی شود.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که تاریخ قبل از تاریخ نسبی داده شده باشد، راه اندازی شود.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	قاعده قالب شرطی را تنظیم می کند تا زمانی که تاریخ برابر با تاریخ معین است، راه اندازی شود.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که یک تاریخ با تاریخ نسبی داده شده برابر است، راه اندازی شود.
`whenFormulaSatisfied(formula)`	`ConditionalFormatRuleBuilder`	زمانی که فرمول داده شده به `true` ارزیابی می شود، قانون قالب شرطی را تنظیم می کند تا راه اندازی شود.
`whenNumberBetween(start, end)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که یک عدد بین دو مقدار مشخص شده قرار می گیرد یا یکی از آن ها باشد، راه اندازی شود.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که یک عدد با مقدار داده شده برابر است، راه اندازی شود.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	قاعده قالب شرطی را طوری تنظیم می کند که وقتی عددی بزرگتر از مقدار داده شده است، راه اندازی شود.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که یک عدد بزرگتر یا مساوی با مقدار داده شده باشد، راه اندازی شود.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	قاعده قالب شرطی شرطی را تنظیم می کند تا زمانی که عددی کمتر از مقدار داده شده باشد، راه اندازی شود.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که عددی کمتر یا مساوی با مقدار داده شده باشد، راه اندازی شود.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	زمانی که عددی بین دو مقدار مشخص شده قرار نمی‌گیرد و هیچ کدام از آن‌ها نیست، قانون قالب شرطی را تنظیم می‌کند.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	زمانی که عددی با مقدار داده شده برابر نیست، قانون قالب شرطی را تنظیم می کند.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که ورودی حاوی مقدار داده شده باشد، راه اندازی شود.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را زمانی تنظیم می کند که ورودی حاوی مقدار داده شده نباشد.
`whenTextEndsWith(text)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که ورودی با مقدار داده شده به پایان می رسد، راه اندازی شود.
`whenTextEqualTo(text)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را تنظیم می کند تا زمانی که ورودی با مقدار داده شده برابر است، راه اندازی شود.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	زمانی که ورودی با مقدار داده شده شروع می شود، قانون قالب شرطی را تنظیم می کند.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	قانون قالب شرطی را بر روی معیارهای تعریف شده توسط مقادیر `BooleanCriteria` تنظیم می کند که معمولاً از `criteria` و `arguments` یک قانون موجود گرفته می شود.

مستندات دقیق

`build()`

یک قانون قالب شرطی از تنظیمات اعمال شده برای سازنده می سازد.

بازگشت

ConditionalFormatRule - نمایشی از قانون قالب شرطی

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

`setBackground(color)`

رنگ پس زمینه را برای قالب قانون قالب شرطی تنظیم می کند. پاس کردن به null ، تنظیم فرمت رنگ پس‌زمینه را از قانون حذف می‌کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	رنگ مورد نظر یا `null` برای پاک شدن.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setBackgroundObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to theme background color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`Color`	شی رنگ مورد نظر یا `null` برای پاک کردن.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن.

`setBold(bold)`

متن پررنگ را برای قالب قاعده قالب شرطی تنظیم می کند. اگر bold true باشد، در صورت وجود شرط، قانون متن را پررنگ می کند. اگر false باشد، در صورت وجود شرط، این قانون هرگونه پررنگی موجود را حذف می کند. پاس کردن به null ، تنظیم فرمت پررنگ را از قانون حذف می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text bold if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`bold`	`Boolean`	در صورت رعایت شرایط قالب، متن باید پررنگ باشد یا نه. `null` این تنظیم را حذف می کند.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setFontColor(color)`

رنگ فونت را برای قالب قاعده قالب شرطی تنظیم می کند. پاس دادن به null ، تنظیم فرمت رنگ فونت را از قانون حذف می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	رنگ مورد نظر یا `null` برای پاک شدن.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setFontColorObject(color)`

رنگ فونت را برای قالب قاعده قالب شرطی تنظیم می کند. پاس دادن به null ، تنظیم فرمت رنگ فونت را از قانون حذف می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to theme text color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`Color`	شی رنگ مورد نظر یا `null` برای پاک کردن.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن.

`setGradientMaxpoint(color)`

مقدار حداکثر گرادیان قانون قالب شرطی را پاک می کند و در عوض از حداکثر مقدار در محدوده های قانون استفاده می کند. همچنین حداکثر رنگ گرادیان را به رنگ ورودی تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	حداکثر رنگ برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setGradientMaxpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`Color`	شیء رنگ حداکثر نقطه برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن.

`setGradientMaxpointObjectWithValue(color, type, value)`

فیلدهای ماکزیمم گرادیان قانون قالب شرطی را تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their
// values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`Color`	حداکثر رنگ برای تنظیم.
`type`	`InterpolationType`	نوع درونیابی حداکثر نقطه برای تنظیم.
`value`	`String`	مقدار حداکثر نقطه برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن.

`setGradientMaxpointWithValue(color, type, value)`

فیلدهای ماکزیمم گرادیان قانون قالب شرطی را تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	حداکثر رنگ برای تنظیم.
`type`	`InterpolationType`	نوع درونیابی حداکثر نقطه برای تنظیم.
`value`	`String`	مقدار حداکثر نقطه برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setGradientMidpointObjectWithValue(color, type, value)`

فیلدهای نقطه میانی گرادیان قانون قالب شرطی را تنظیم می کند. اگر نوع درونیابی null باشد، تمام فیلدهای نقطه میانی را پاک می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`Color`	رنگ نقطه میانی برای تنظیم.
`type`	`InterpolationType`	نوع درونیابی نقطه میانی برای تنظیم یا `null` برای پاک کردن.
`value`	`String`	مقدار نقطه میانی برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن.

`setGradientMidpointWithValue(color, type, value)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	رنگ نقطه میانی برای تنظیم.
`type`	`InterpolationType`	نوع درونیابی نقطه میانی برای تنظیم یا `null` برای پاک کردن.
`value`	`String`	مقدار نقطه میانی برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setGradientMinpoint(color)`

مقدار حداقل گرادیان قانون قالب شرطی را پاک می‌کند و در عوض از حداقل مقدار در محدوده‌های قانون استفاده می‌کند. همچنین رنگ minpoint گرادیان را به رنگ ورودی تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	رنگ نقطه ای که باید تنظیم شود.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setGradientMinpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`Color`	شی رنگ minpoint برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن.

`setGradientMinpointObjectWithValue(color, type, value)`

فیلدهای نقطه گرادیان قانون قالب شرطی را تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`Color`	رنگ نقطه ای که باید تنظیم شود.
`type`	`InterpolationType`	نوع درونیابی نقطه کوچک برای تنظیم.
`value`	`String`	مقدار minpoint برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن.

`setGradientMinpointWithValue(color, type, value)`

فیلدهای نقطه گرادیان قانون قالب شرطی را تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red to green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`color`	`String`	رنگ نقطه ای که باید تنظیم شود.
`type`	`InterpolationType`	نوع درونیابی نقطه کوچک برای تنظیم.
`value`	`String`	مقدار minpoint برای تنظیم.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setItalic(italic)`

حالت مورب متن را برای قالب قاعده قالب شرطی تنظیم می کند. اگر italic true باشد، در صورت وجود شرط، قاعده متن را کج می‌کند. اگر false باشد، در صورت وجود شرط، قاعده هر گونه ایتالیک موجود را حذف می کند. با ارسال null ، تنظیم فرمت ایتالیک از قانون حذف می شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text italic if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setItalic(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`italic`	`Boolean`	در صورت رعایت شرایط قالب، متن باید مورب باشد یا نه. `null` این تنظیم را حذف می کند.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setRanges(ranges)`

یک یا چند محدوده را تنظیم می کند که این قانون قالب شرطی برای آنها اعمال می شود. این عملیات جایگزین هر محدوده موجود می شود. تنظیم یک آرایه خالی همه محدوده های موجود را پاک می کند. یک قانون باید حداقل یک محدوده داشته باشد.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6
// to turn red if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`ranges`	`Range[]`	محدوده هایی که این قانون قالب شرطی برای آنها اعمال می شود.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setStrikethrough(strikethrough)`

خط خطی متن را برای قالب قاعده قالب شرطی تنظیم می کند. اگر strikethrough true باشد، در صورتی که شرط برقرار باشد، متن قانون خط خورده است. اگر false باشد، در صورت وجود شرط، این قانون هرگونه قالب بندی خطی موجود را حذف می کند. پاس کردن به null ، تنظیم قالب خط خطی را از قانون حذف می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setStrikethrough(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`strikethrough`	`Boolean`	در صورتی که شرط قالب برآورده شود، آیا متن باید به صورت کامل مشخص شود یا خیر. `null` این تنظیم را حذف می کند.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`setUnderline(underline)`

زیرخط متن را برای قالب قاعده قالب شرطی تنظیم می کند. اگر underline true باشد، در صورت وجود شرط، قانون زیر متن زیر خط می کشد. اگر false باشد، در صورت برآورده شدن شرط، این قانون زیرخط های موجود را حذف می کند. پاس دادن به null ، تنظیم قالب زیر خط را از قانون حذف می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`underline`	`Boolean`	در صورت رعایت شرایط قالب، متن باید زیر خط کشیده شود یا خیر. `null` این تنظیم را حذف می کند.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenCellEmpty()`

قانون قالب شرطی را تنظیم می کند تا زمانی که سلول خالی است راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenCellNotEmpty()`

قانون قالب مشروط را به گونه ای تنظیم می کند که وقتی سلول خالی نیست راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are not empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenDateAfter(date)`

قاعده قالب شرطی را تنظیم می کند تا زمانی که تاریخ بعد از مقدار داده شده است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	آخرین تاریخ.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenDateAfter(date)`

قاعده قالب شرطی را تنظیم می کند تا زمانی که یک تاریخ بعد از تاریخ نسبی داده شده است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`date`	`RelativeDate`	آخرین تاریخ نسبت به نوع تاریخ انتخاب شده.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenDateBefore(date)`

قاعده قالب شرطی را تنظیم می کند تا زمانی که تاریخ قبل از تاریخ معین است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	اولین تاریخ غیر قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenDateBefore(date)`

قانون قالب شرطی را تنظیم می کند تا زمانی که تاریخ قبل از تاریخ نسبی داده شده باشد، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`date`	`RelativeDate`	آخرین تاریخ نسبت به نوع تاریخ انتخاب شده.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenDateEqualTo(date)`

قاعده قالب شرطی را تنظیم می کند تا زمانی که تاریخ برابر با تاریخ معین است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the date 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Date`	تنها تاریخ قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenDateEqualTo(date)`

قانون قالب شرطی را تنظیم می کند تا زمانی که یک تاریخ با تاریخ نسبی داده شده برابر است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain todays date.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`date`	`RelativeDate`	آخرین تاریخ نسبت به نوع تاریخ انتخاب شده.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenFormulaSatisfied(formula)`

زمانی که فرمول داده شده به true ارزیابی می شود، قانون قالب شرطی را تنظیم می کند تا راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they satisfy the condition "=EQ(B4, C3)".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied("=EQ(B4, C3)")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`formula`	`String`	یک فرمول سفارشی که در صورت معتبر بودن ورودی به `true` ارزیابی می شود.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberBetween(start, end)`

قانون قالب شرطی را تنظیم می کند تا زمانی که یک عدد بین دو مقدار مشخص شده قرار می گیرد یا یکی از آن ها باشد، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`start`	`Number`	کمترین مقدار قابل قبول
`end`	`Number`	بالاترین مقدار قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberEqualTo(number)`

قانون قالب شرطی را تنظیم می کند تا زمانی که یک عدد با مقدار داده شده برابر است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	تنها ارزش قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberGreaterThan(number)`

قاعده قالب شرطی را طوری تنظیم می کند که وقتی عددی بزرگتر از مقدار داده شده است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red
// if they contain a number greater than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	بالاترین ارزش غیر قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberGreaterThanOrEqualTo(number)`

قانون قالب شرطی را تنظیم می کند تا زمانی که یک عدد بزرگتر یا مساوی با مقدار داده شده باشد، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number greater than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	کمترین مقدار قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberLessThan(number)`

قاعده قالب شرطی شرطی را تنظیم می کند تا زمانی که عددی کمتر از مقدار داده شده باشد، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	کمترین مقدار غیر قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberLessThanOrEqualTo(number)`

قانون قالب شرطی را تنظیم می کند تا زمانی که عددی کمتر یا مساوی با مقدار داده شده باشد، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	بالاترین مقدار قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberNotBetween(start, end)`

زمانی که عددی بین دو مقدار مشخص شده قرار نمی‌گیرد و هیچ کدام از آن‌ها نیست، قانون قالب شرطی را تنظیم می‌کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number not between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`start`	`Number`	کمترین مقدار غیر قابل قبول
`end`	`Number`	بالاترین ارزش غیر قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenNumberNotEqualTo(number)`

زمانی که عددی با مقدار داده شده برابر نیست، قانون قالب شرطی را تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`number`	`Number`	تنها ارزش غیر قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenTextContains(text)`

قانون قالب شرطی را تنظیم می کند تا زمانی که ورودی حاوی مقدار داده شده باشد، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextContains("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	مقداری که ورودی باید حاوی آن باشد.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenTextDoesNotContain(text)`

قانون قالب شرطی را زمانی تنظیم می کند که ورودی حاوی مقدار داده شده نباشد.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextDoesNotContain("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	مقداری که ورودی نباید حاوی آن باشد.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenTextEndsWith(text)`

قانون قالب شرطی را تنظیم می کند تا زمانی که ورودی با مقدار داده شده به پایان می رسد، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they end with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	متن برای مقایسه در انتهای رشته.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenTextEqualTo(text)`

قانون قالب شرطی را تنظیم می کند تا زمانی که ورودی با مقدار داده شده برابر است، راه اندازی شود.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they have text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	تنها ارزش قابل قبول

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`whenTextStartsWith(text)`

زمانی که ورودی با مقدار داده شده شروع می شود، قانون قالب شرطی را تنظیم می کند.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they start with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`text`	`String`	متن برای مقایسه با ابتدای رشته.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن

`withCriteria(criteria, args)`

قانون قالب شرطی را بر روی معیارهای تعریف شده توسط مقادیر BooleanCriteria تنظیم می کند که معمولاً از criteria و arguments یک قانون موجود گرفته می شود.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
var booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  var rule = SpreadsheetApp.newConditionalFormatRule()
      .withCriteria(booleanCondition.getCriteriaType(),
         booleanCondition.getCriteriaValues())
      .setBackground("#000000")
      .setRanges(rule.getRanges())
      .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

پارامترها

نام	تایپ کنید	توضیحات
`criteria`	`BooleanCriteria`	نوع معیار قالب مشروط.
`args`	`Object[]`	آرایه ای از آرگومان های متناسب با نوع معیار؛ تعداد آرگومان ها و نوع آنها با متد `when...()` بالا مطابقت دارد.

بازگشت

ConditionalFormatRuleBuilder - سازنده، برای زنجیر کردن