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	اگر این قانون از معیارهای شرط بولی استفاده کند، اطلاعات Boolean Condition قانون را بازیابی می کند.
get Gradient Condition()	Gradient Condition	اگر این قانون از معیارهای شرایط گرادیان استفاده کند، اطلاعات 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	مقدار حداکثر گرادیان قانون قالب شرطی را پاک می کند و در عوض از حداکثر مقدار در محدوده های قانون استفاده می کند.
set Gradient Maxpoint Object(color)	Conditional Format Rule Builder	مقدار حداکثر گرادیان قانون قالب شرطی را پاک می کند و در عوض از حداکثر مقدار در محدوده های قانون استفاده می کند.
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 .

---

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 .

---

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 تنظیم فرمت پررنگ را از قانون حذف می کند.

// 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	شیء رنگ حداکثر نقطه برای تنظیم.

بازگشت

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)

مقدار حداقل گرادیان قانون قالب شرطی را پاک می‌کند و در عوض از حداقل مقدار در محدوده‌های قانون استفاده می‌کند. همچنین رنگ 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.

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)

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

// 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	مقدار minpoint برای تنظیم.

بازگشت

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	مقدار minpoint برای تنظیم.

بازگشت

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 ارزیابی می شود.

بازگشت

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 - سازنده، برای زنجیر کردن