سازنده قوانین قالب مشروط.
// 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
- سازنده، برای زنجیر کردن