Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

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

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

مواد و روش ها

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

مستندات دقیق

build()

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

برگشت

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

---

copy()

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

برگشت

ConditionalFormatRuleBuilder - سازنده بر اساس تنظیمات این قانون

---

getBooleanCondition()

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

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

برگشت

BooleanCondition - شی شرط بولی، یا اگر قانون از شرط بولی استفاده نکند null .

---

getGradientCondition()

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

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

برگشت

GradientCondition - شی شرط گرادیان، یا اگر قانون از شرط گرادیان استفاده نکند null .

---

getRanges()

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

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

برگشت

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

---

setBackground(color)

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

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

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

مولفه های

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

برگشت

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

---

setBackgroundObject(color)

رنگ پس زمینه را برای قالب قانون قالب شرطی تنظیم می کند. پاس کردن به صورت 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".

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

مولفه های

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

برگشت

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

---

setBold(bold)

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

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

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

مولفه های

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

برگشت

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

---

setFontColor(color)

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

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

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

مولفه های

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

برگشت

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

---

setFontColorObject(color)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMaxpoint(color)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMaxpointObject(color)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMaxpointObjectWithValue(color, type, value)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMaxpointWithValue(color, type, value)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMidpointObjectWithValue(color, type, value)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMidpointWithValue(color, type, value)

فیلدهای نقطه میانی گرادیان قانون قالب شرطی را تنظیم می کند. اگر نوع درونیابی 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.

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

مولفه های

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

برگشت

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

---

setGradientMinpoint(color)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMinpointObject(color)

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

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

مولفه های

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

برگشت

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

---

setGradientMinpointObjectWithValue(color, type, value)

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

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

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

مولفه های

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

برگشت

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

---

setGradientMinpointWithValue(color, type, value)

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

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

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

مولفه های

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

برگشت

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

---

setItalic(italic)

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

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

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

مولفه های

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

برگشت

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

---

setRanges(ranges)

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

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

مولفه های

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

برگشت

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

---

setStrikethrough(strikethrough)

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

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

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

مولفه های

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

برگشت

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

---

setUnderline(underline)

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

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

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

مولفه های

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

برگشت

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

---

whenCellEmpty()

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

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

برگشت

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

---

whenCellNotEmpty()

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

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

برگشت

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

---

whenDateAfter(date)

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

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

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

مولفه های

نام	تایپ کنید	شرح
date	Date	آخرین تاریخ.

برگشت

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

---

whenDateAfter(date)

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

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

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

مولفه های

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

برگشت

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

---

whenDateBefore(date)

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

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

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

مولفه های

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

برگشت

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

---

whenDateBefore(date)

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

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

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

مولفه های

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

برگشت

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

---

whenDateEqualTo(date)

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

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

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

مولفه های

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

برگشت

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

---

whenDateEqualTo(date)

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

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

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

مولفه های

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

برگشت

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

---

whenFormulaSatisfied(formula)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberBetween(start, end)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberEqualTo(number)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberGreaterThan(number)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberGreaterThanOrEqualTo(number)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberLessThan(number)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberLessThanOrEqualTo(number)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberNotBetween(start, end)

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

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

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

مولفه های

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

برگشت

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

---

whenNumberNotEqualTo(number)

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

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

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

مولفه های

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

برگشت

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

---

whenTextContains(text)

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

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

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

مولفه های

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

برگشت

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

---

whenTextDoesNotContain(text)

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

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

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

مولفه های

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

برگشت

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

---

whenTextEndsWith(text)

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

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

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

مولفه های

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

برگشت

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

---

whenTextEqualTo(text)

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

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

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

مولفه های

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

برگشت

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

---

whenTextStartsWith(text)

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

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

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

مولفه های

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

برگشت

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

---

withCriteria(criteria, args)

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

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

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

مولفه های

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

برگشت

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