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