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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

روش‌ها

روش نوع بازگشتی شرح مختصر
build() Conditional Format Rule یک قانون قالب‌بندی شرطی از تنظیمات اعمال شده به سازنده می‌سازد.
copy() Conditional Format Rule Builder یک پیش‌تنظیم سازنده‌ی قانون با تنظیمات این قانون برمی‌گرداند.
get Boolean Condition() Boolean Condition |null اگر این قانون از معیارهای شرط بولی استفاده کند، اطلاعات Boolean Condition آن قانون را بازیابی می‌کند.
get Gradient Condition() Gradient Condition |null اطلاعات Gradient Condition قانون را بازیابی می‌کند، اگر این قانون از معیارهای شرط گرادیان استفاده کند.
get Ranges() Range[] محدوده‌هایی را که این قانون قالب‌بندی شرطی به آنها اعمال می‌شود، بازیابی می‌کند.
set Background(color) Conditional Format Rule Builder رنگ پس‌زمینه را برای قالب قانون قالب‌بندی شرطی تنظیم می‌کند.
set Background Object(color) Conditional Format Rule Builder رنگ پس‌زمینه را برای قالب قانون قالب‌بندی شرطی تنظیم می‌کند.
set Bold(bold) Conditional Format Rule Builder میزان پررنگ شدن متن را برای قالب قانون قالب‌بندی شرطی تنظیم می‌کند.
set Font Color(color) Conditional Format Rule Builder رنگ فونت را برای قالب قانون قالب‌بندی شرطی تنظیم می‌کند.
set Font Color Object(color) Conditional Format Rule Builder رنگ فونت را برای قالب قانون قالب‌بندی شرطی تنظیم می‌کند.
set Gradient Maxpoint(color) Conditional Format Rule Builder مقدار گرادیان maxpoint قانون قالب‌بندی شرطی را پاک می‌کند و در عوض از حداکثر مقدار در محدوده‌های قانون استفاده می‌کند.
set Gradient Maxpoint Object(color) Conditional Format Rule Builder مقدار گرادیان maxpoint قانون قالب‌بندی شرطی را پاک می‌کند و در عوض از حداکثر مقدار در محدوده‌های قانون استفاده می‌کند.
set Gradient Maxpoint Object With Value(color, type, value) Conditional Format Rule Builder فیلدهای حداکثر نقطه گرادیان قانون قالب‌بندی شرطی را تنظیم می‌کند.
set Gradient Maxpoint With Value(color, type, value) Conditional Format Rule Builder فیلدهای حداکثر نقطه گرادیان قانون قالب‌بندی شرطی را تنظیم می‌کند.
set Gradient Midpoint Object With Value(color, type, value) Conditional Format Rule Builder فیلدهای نقطه میانی گرادیان قانون قالب‌بندی شرطی را تنظیم می‌کند.
set Gradient Midpoint With Value(color, type, value) Conditional Format Rule Builder فیلدهای نقطه میانی گرادیان قانون قالب‌بندی شرطی را تنظیم می‌کند.
set Gradient Minpoint(color) Conditional Format Rule Builder مقدار نقطه حداقل گرادیان قانون قالب‌بندی شرطی را پاک می‌کند و در عوض از حداقل مقدار در محدوده‌های قانون استفاده می‌کند.
set Gradient Minpoint Object(color) Conditional Format Rule Builder مقدار نقطه حداقل گرادیان قانون قالب‌بندی شرطی را پاک می‌کند و در عوض از حداقل مقدار در محدوده‌های قانون استفاده می‌کند.
set Gradient Minpoint Object With Value(color, type, value) Conditional Format Rule Builder فیلدهای نقطه‌ی حداقل گرادیان قانون قالب‌بندی شرطی را تنظیم می‌کند.
set Gradient Minpoint With Value(color, type, value) Conditional Format Rule Builder فیلدهای نقطه‌ی حداقل گرادیان قانون قالب‌بندی شرطی را تنظیم می‌کند.
set Italic(italic) Conditional Format Rule Builder متن را برای قالب قانون قالب‌بندی شرطی به صورت مورب تنظیم می‌کند.
set Ranges(ranges) Conditional Format Rule Builder یک یا چند محدوده را که این قانون قالب‌بندی شرطی روی آنها اعمال می‌شود، تنظیم می‌کند.
set Strikethrough(strikethrough) Conditional Format Rule Builder متن خط خورده را برای قالب قانون قالب‌بندی شرطی تنظیم می‌کند.
set Underline(underline) Conditional Format Rule Builder زیرخط‌دار شدن متن را برای قالب قانون قالب‌بندی شرطی تنظیم می‌کند.
when Cell Empty() Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا در صورت خالی بودن سلول فعال شود.
when Cell Not Empty() Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی سلول خالی نیست، فعال شود.
when Date After(date) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی تاریخ بعد از مقدار داده شده قرار می‌گیرد، فعال شود.
when Date After(date) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی یک تاریخ بعد از تاریخ نسبی داده شده قرار می‌گیرد، فعال شود.
when Date Before(date) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی تاریخ قبل از تاریخ داده شده است، فعال شود.
when Date Before(date) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی یک تاریخ قبل از تاریخ نسبی داده شده است، فعال شود.
when Date Equal To(date) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی تاریخ برابر با تاریخ داده شده است، فعال شود.
when Date Equal To(date) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا زمانی که یک تاریخ برابر با تاریخ نسبی داده شده باشد، فعال شود.
when Formula Satisfied(formula) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا زمانی که فرمول داده شده به true ارزیابی شود، فعال شود.
when Number Between(start, end) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی یک عدد بین دو مقدار مشخص شده قرار می‌گیرد یا یکی از آنها است، فعال شود.
when Number Equal To(number) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی عددی برابر با مقدار داده شده است، فعال شود.
when Number Greater Than(number) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی عددی بزرگتر از مقدار داده شده است، فعال شود.
when Number Greater Than Or Equal To(number) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی عددی بزرگتر یا مساوی مقدار داده شده است، فعال شود.
when Number Less Than(number) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی عددی کمتر از مقدار داده شده باشد، فعال شود.
when Number Less Than Or Equal To(number) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی عددی کمتر یا مساوی مقدار داده شده باشد، فعال شود.
when Number Not Between(start, end) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا زمانی که یک عدد بین دو مقدار مشخص شده قرار نمی‌گیرد و هیچ‌کدام از آنها نیست، فعال شود.
when Number Not Equal To(number) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا در صورت برابر نبودن یک عدد با مقدار داده شده، فعال شود.
when Text Contains(text) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا زمانی که ورودی حاوی مقدار داده شده باشد، فعال شود.
when Text Does Not Contain(text) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا زمانی که ورودی حاوی مقدار داده شده نیست، فعال شود.
when Text Ends With(text) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی ورودی با مقدار داده شده پایان می‌یابد، فعال شود.
when Text Equal To(text) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا زمانی که ورودی برابر با مقدار داده شده باشد، فعال شود.
when Text Starts With(text) Conditional Format Rule Builder قانون قالب‌بندی شرطی را تنظیم می‌کند تا وقتی ورودی با مقدار داده شده شروع می‌شود، فعال شود.
with Criteria(criteria, args) Conditional Format Rule Builder قانون قالب‌بندی شرطی را روی معیارهای تعریف‌شده توسط مقادیر Boolean Criteria تنظیم می‌کند، که معمولاً از criteria و arguments یک قانون موجود گرفته می‌شوند.

مستندات دقیق

build()

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

بازگشت

Conditional Format Rule - نمایشی از قانون قالب‌بندی شرطی.


copy()

یک پیش‌تنظیم سازنده‌ی قانون با تنظیمات این قانون برمی‌گرداند.

بازگشت

Conditional Format Rule Builder — سازنده‌ای بر اساس تنظیمات این قانون.


get Boolean Condition()

اگر این قانون از معیارهای شرط بولی استفاده کند، اطلاعات Boolean Condition قانون را بازیابی می‌کند. در غیر این صورت null را برمی‌گرداند.

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

بازگشت

Boolean Condition |null — شیء شرط بولی، یا اگر قانون از شرط بولی استفاده نکند، null .


get Gradient Condition()

اگر این قانون از معیارهای شرط Gradient Condition استفاده کند، اطلاعات شرط گرادیان قانون را بازیابی می‌کند. در غیر این صورت null را برمی‌گرداند.

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

بازگشت

Gradient Condition |null — شیء شرط گرادیان، یا اگر قانون از شرط گرادیان استفاده نکند، null .


get Ranges()

محدوده‌هایی را که این قانون قالب‌بندی شرطی به آنها اعمال می‌شود، بازیابی می‌کند.

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

بازگشت

Range[] — محدوده‌هایی که این قانون قالب‌بندی شرطی روی آنها اعمال می‌شود.


set Background(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Background Object(color)

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

// 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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Bold(bold)

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

// 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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Font Color(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Font Color Object(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Maxpoint(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.

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Maxpoint Object(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.

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

پارامترها

نام نوع توضیحات
color Color شیء رنگ maxpoint که باید تنظیم شود.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Maxpoint Object With Value(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.

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

پارامترها

نام نوع توضیحات
color Color حداکثر رنگ برای تنظیم.
type Interpolation Type نوع درون‌یابی حداکثر نقطه‌ای که باید تنظیم شود.
value String حداکثر مقدار نقطه‌ای که باید تنظیم شود.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Maxpoint With Value(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.

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

پارامترها

نام نوع توضیحات
color String حداکثر رنگ برای تنظیم.
type Interpolation Type نوع درون‌یابی حداکثر نقطه‌ای که باید تنظیم شود.
value String حداکثر مقدار نقطه‌ای که باید تنظیم شود.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Midpoint Object With Value(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.

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Midpoint With Value(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 red green to blue, based on their
// values in comparison to the values 0, 50, and 100.

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Minpoint(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.

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

پارامترها

نام نوع توضیحات
color String رنگ نقطه پایانی برای تنظیم.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Minpoint Object(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.

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

پارامترها

نام نوع توضیحات
color Color شیء رنگ minpoint برای تنظیم.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Minpoint Object With Value(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.

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

پارامترها

نام نوع توضیحات
color Color رنگ نقطه پایانی برای تنظیم.
type Interpolation Type نوع درون‌یابی نقطه‌ای که باید تنظیم شود.
value String مقدار نقطه پایانی که باید تنظیم شود.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Gradient Minpoint With Value(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.

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

پارامترها

نام نوع توضیحات
color String رنگ نقطه پایانی برای تنظیم.
type Interpolation Type نوع درون‌یابی نقطه‌ای که باید تنظیم شود.
value String مقدار نقطه پایانی که باید تنظیم شود.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Italic(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Ranges(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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeOne = sheet.getRange('A1:B3');
const rangeTwo = sheet.getRange('D4:F6');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([rangeOne, rangeTwo])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Strikethrough(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


set Underline(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Cell Empty()

قانون قالب‌بندی شرطی را تنظیم می‌کند تا در صورت خالی بودن سلول فعال شود.

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Cell Not Empty()

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

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Date After(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.

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

پارامترها

نام نوع توضیحات
date Date جدیدترین تاریخ.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Date After(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.

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

پارامترها

نام نوع توضیحات
date Relative Date آخرین تاریخ نسبت به نوع تاریخ انتخاب شده.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Date Before(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.

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

پارامترها

نام نوع توضیحات
date Date زودترین تاریخ غیرقابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Date Before(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.

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

پارامترها

نام نوع توضیحات
date Relative Date آخرین تاریخ نسبت به نوع تاریخ انتخاب شده.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Date Equal To(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.

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

پارامترها

نام نوع توضیحات
date Date تنها تاریخ قابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Date Equal To(date)

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

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

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

پارامترها

نام نوع توضیحات
date Relative Date آخرین تاریخ نسبت به نوع تاریخ انتخاب شده.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Formula Satisfied(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)".

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

پارامترها

نام نوع توضیحات
formula String یک فرمول سفارشی که در صورت معتبر بودن ورودی، مقدار true (true) را ارزیابی می‌کند.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Between(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.

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Equal To(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.

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

پارامترها

نام نوع توضیحات
number Number تنها مقدار قابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Greater Than(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.

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

پارامترها

نام نوع توضیحات
number Number بالاترین مقدار غیرقابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Greater Than Or Equal To(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.

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Less Than(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.

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Less Than Or Equal To(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.

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

پارامترها

نام نوع توضیحات
number Number بالاترین مقدار قابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Not Between(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.

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

پارامترها

نام نوع توضیحات
start Number کمترین مقدار غیرقابل قبول.
end Number بالاترین مقدار غیرقابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Number Not Equal To(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.

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

پارامترها

نام نوع توضیحات
number Number تنها مقدار غیرقابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Text Contains(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Text Does Not Contain(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Text Ends With(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".

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

پارامترها

نام نوع توضیحات
text String متن برای مقایسه با انتهای رشته.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Text Equal To(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".

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

پارامترها

نام نوع توضیحات
text String تنها مقدار قابل قبول.

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


when Text Starts With(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".

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.


with Criteria(criteria, args)

قانون قالب‌بندی شرطی را روی معیارهای تعریف‌شده توسط مقادیر Boolean Criteria تنظیم می‌کند، که معمولاً از 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.

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

پارامترها

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

بازگشت

Conditional Format Rule Builder - سازنده، برای زنجیره‌سازی.