به شرایط بولی در ConditionalFormatRules
دسترسی پیدا کنید. هر قانون قالب شرطی ممکن است شامل یک شرط بولی واحد باشد. شرط بولی خود شامل معیارهای بولی (با مقادیر) و تنظیمات قالب بندی است. معیارها بر اساس محتوای یک سلول ارزیابی می شوند که منجر به یک مقدار true
یا false
می شود. اگر معیار به true
ارزیابی شود، تنظیمات قالب بندی شرط در سلول اعمال می شود.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
getBackgroundObject() | Color | رنگ پس زمینه این شرط بولی را دریافت می کند. |
getBold() | Boolean | اگر این شرط بولی متن را پررنگ کند true برمیگرداند و اگر این شرط بولی بولدینگ را از متن حذف کند، false برمیگرداند. |
getCriteriaType() | BooleanCriteria | نوع معیار قانون را همانطور که در فهرست BooleanCriteria تعریف شده است دریافت می کند. |
getCriteriaValues() | Object[] | آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. |
getFontColorObject() | Color | رنگ فونت را برای این شرط بولی دریافت می کند. |
getItalic() | Boolean | اگر این شرط بولی متن را ایتالیک کند true برمیگرداند و اگر این شرط بولی حروف کج را از متن حذف کند، false برمیگرداند. |
getStrikethrough() | Boolean | اگر این شرط بولی از متن عبور کند true برمی گرداند و اگر این شرط بولی خط خطی را از متن حذف کند، false برمی گرداند. |
getUnderline() | Boolean | اگر این شرط بولی زیر متن زیر خط بکشد true برمیگرداند و اگر این شرط بولی خط زیر را از متن حذف کند، false برمیگرداند. |
مستندات دقیق
getBackgroundObject()
رنگ پس زمینه این شرط بولی را دریافت می کند. اگر تنظیم نشود، null
برمیگرداند.
// Logs the boolean condition background color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getBackgroundObject(); Logger.log("The background color for rule %s is %s", i, color.asRgbColor().asHexString()); }
برگشت
Color
- رنگ پسزمینه، یا اگر برای این شرط تنظیم نشده باشد، null
.
getBold()
اگر این شرط بولی متن را پررنگ کند true
برمیگرداند و اگر این شرط بولی بولدینگ را از متن حذف کند، false
برمیگرداند. اگر پررنگ شدن تحت تأثیر قرار نگیرد، null
برمیگرداند.
// Logs the boolean condition font weight for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var bold = rules[i].getBooleanCondition().getBold(); Logger.log("The font bold setting for rule %s is %b", i, weight); }
برگشت
Boolean
- اینکه آیا شرط بولی متن را پررنگ می کند یا نه، یا اگر پررنگ شدن تأثیری نداشته باشد null
.
getCriteriaType()
نوع معیار قانون را همانطور که در فهرست BooleanCriteria
تعریف شده است دریافت می کند. برای بدست آوردن آرگومان های معیارها، از getCriteriaValues()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا تغییر یک قانون قالب بندی شرطی، ConditionalFormatRuleBuilder.withCriteria(criteria, args)
را ببینید.
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
برگشت
BooleanCriteria
- نوع معیارهای قالب بندی شرطی
getCriteriaValues()
آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، از getCriteriaType()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا تغییر یک قانون قالب بندی شرطی، ConditionalFormatRuleBuilder.withCriteria(criteria, args)
را ببینید.
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
برگشت
Object[]
- آرایه ای از آرگومان های مناسب با نوع معیار قاعده. تعداد آرگومانها و نوع آنها با متد when...()
کلاس ConditionalFormatRuleBuilder
مطابقت دارد.
getFontColorObject()
رنگ فونت را برای این شرط بولی دریافت می کند. اگر تنظیم نشود، null
برمیگرداند.
// Logs the boolean condition font color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getFontColorObject(); Logger.log("The font color for rule %s is %s", i, color.asRgbColor().asHexString()); }
برگشت
Color
- رنگ قلم، یا اگر برای این شرط تنظیم نشده باشد، null
.
getItalic()
اگر این شرط بولی متن را ایتالیک کند true
برمیگرداند و اگر این شرط بولی حروف کج را از متن حذف کند، false
برمیگرداند. در صورتی که حروف کج تحت تاثیر قرار نگیرد، null
برمیگرداند.
// Logs the boolean condition font style for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var italic = rules[i].getBooleanCondition().getItalic(); Logger.log("The font italic setting for rule %s is %b", i, italic); }
برگشت
Boolean
- چه شرط بولی متن را ایتالیک کند یا نه، یا اگر ایتالیس تأثیری نداشته باشد، null
.
getStrikethrough()
اگر این شرط بولی از متن عبور کند true
برمی گرداند و اگر این شرط بولی خط خطی را از متن حذف کند، false
برمی گرداند. اگر خط خطی تحت تأثیر قرار نگیرد، null
برمیگرداند.
// Logs the boolean condition strikethrough setting for each conditional format rule on a // sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var strikethrough = rules[i].getBooleanCondition().getStrikethrough(); Logger.log("The font strikethrough setting for rule %s is %b", i, strikethrough); }
برگشت
Boolean
- چه شرط بولی در متن باشد یا نه، یا اگر خط خطی تحت تأثیر قرار نگیرد null
getUnderline()
اگر این شرط بولی زیر متن زیر خط بکشد true
برمیگرداند و اگر این شرط بولی خط زیر را از متن حذف کند، false
برمیگرداند. در صورتی که خط زیر تاثیری نداشته باشد، null
برمیگرداند.
// Logs the boolean condition underline setting for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var underline = rules[i].getBooleanCondition().getUnderline(); Logger.log("The font underline setting for rule %s is %b", i, underline); }
برگشت
Boolean
- اینکه آیا شرط بولی زیر متن زیر خط میکشد یا نه، یا اگر زیرخطگذاری تأثیری نداشته باشد، null
.