دسترسی به شرایط بولی در Conditional Format Rules
. هر قانون قالب شرطی ممکن است شامل یک شرط بولی واحد باشد. شرط بولی خود شامل معیارهای بولی (با مقادیر) و تنظیمات قالب بندی است. معیارها بر اساس محتوای یک سلول ارزیابی می شوند که منجر به یک مقدار true
یا false
می شود. اگر معیار به true
ارزیابی شود، تنظیمات قالب بندی شرط در سلول اعمال می شود.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
get Background Object() | Color | رنگ پس زمینه این شرط بولی را دریافت می کند. |
get Bold() | Boolean | اگر این شرط بولی متن را پررنگ کند true برمیگرداند و اگر این شرط بولی بولدینگ را از متن حذف کند، false را برمیگرداند. |
get Criteria Type() | Boolean Criteria | نوع معیار قانون را همانطور که در فهرست Boolean Criteria تعریف شده است، دریافت می کند. |
get Criteria Values() | Object[] | آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. |
get Font Color Object() | Color | رنگ فونت را برای این شرط بولی دریافت می کند. |
get Italic() | Boolean | اگر این شرط بولی متن را ایتالیک کند true برمیگرداند و اگر این شرط بولی حروف کج را از متن حذف کند، false را برمیگرداند. |
get Strikethrough() | Boolean | اگر این شرط بولی از متن عبور کند true برمی گرداند و اگر این شرط بولی خط خطی را از متن حذف کند، false را برمی گرداند. |
get Underline() | Boolean | اگر این شرط بولی زیر متن زیر خط بکشد true برمیگرداند و اگر این شرط بولی خط زیر را از متن حذف کند، false را برمیگرداند. |
مستندات دقیق
get Background Object()
رنگ پس زمینه این شرط بولی را دریافت می کند. اگر تنظیم نشود، null
برمیگرداند.
// Logs the boolean condition background color for each conditional format rule // on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const color = rule.getBooleanCondition().getBackgroundObject(); Logger.log(`Background color: ${color.asRgbColor().asHexString()}`); }
بازگشت
Color
- رنگ پسزمینه، یا اگر برای این شرط تنظیم نشده باشد، null
.
get Bold()
اگر این شرط بولی متن را پررنگ کند true
برمیگرداند و اگر این شرط بولی بولدینگ را از متن حذف کند، false
را برمیگرداند. اگر پررنگ شدن تحت تأثیر قرار نگیرد، null
برمیگرداند.
// Logs the boolean condition font weight for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const bold = rule.getBooleanCondition().getBold(); Logger.log(`Bold: ${bold}`); }
بازگشت
Boolean
- اینکه آیا شرط بولی متن را پررنگ می کند یا نه، یا اگر پررنگ شدن تأثیری نداشته باشد، null
.
get Criteria Type()
نوع معیار قانون را همانطور که در فهرست Boolean Criteria
تعریف شده است، دریافت می کند. برای بدست آوردن آرگومان های معیارها، get Criteria Values()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون قالب بندی شرطی، Conditional Format Rule Builder.withCriteria(criteria, args)
ببینید.
// Log information about the conditional formats on the active sheet that use // boolean conditions. const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats(); SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => { const booleanCondition = format.getBooleanCondition(); if (booleanCondition) { const criteria = booleanCondition.getCriteriaType(); const args = booleanCondition.getCriteriaValues(); Logger.log(`The conditional format rule is ${criteria} ${args}`); } });
بازگشت
Boolean Criteria
- نوع معیارهای قالب بندی شرطی.
get Criteria Values()
آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، get Criteria Type()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون قالب بندی شرطی، Conditional Format Rule Builder.withCriteria(criteria, args)
ببینید.
// Log information about the conditional formats on the active sheet that use // boolean conditions. const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats(); SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => { const booleanCondition = format.getBooleanCondition(); if (booleanCondition) { const criteria = booleanCondition.getCriteriaType(); const args = booleanCondition.getCriteriaValues(); Logger.log(`The conditional format rule is ${criteria} ${args}`); } });
بازگشت
Object[]
- آرایه ای از آرگومان های متناسب با نوع معیار قاعده. تعداد آرگومان ها و نوع آنها با متد when...()
کلاس Conditional Format Rule Builder
مطابقت دارد.
get Font Color Object()
رنگ فونت را برای این شرط بولی دریافت می کند. اگر تنظیم نشود، null
برمیگرداند.
// Logs the boolean condition font color for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const color = rule.getBooleanCondition().getFontColorObject(); Logger.log(`Font color: ${color.asRgbColor().asHexString()}`); }
بازگشت
Color
- رنگ قلم، یا اگر برای این شرط تنظیم نشده باشد null
.
get Italic()
اگر این شرط بولی متن را ایتالیک کند true
برمیگرداند و اگر این شرط بولی حروف کج را از متن حذف کند، false
را برمیگرداند. در صورتی که حروف کج تحت تاثیر قرار نگیرد، null
برمیگرداند.
// Logs the boolean condition font style for each conditional format rule on a // sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const italic = rule.getBooleanCondition().getItalic(); Logger.log(`Italic: ${italic}`); }
بازگشت
Boolean
- چه شرط بولی متن را ایتالیک کند یا نه، یا اگر ایتالیس تأثیری نداشته باشد، null
get Strikethrough()
اگر این شرط بولی از متن عبور کند true
برمی گرداند و اگر این شرط بولی خط خطی را از متن حذف کند، false
را برمی گرداند. اگر خط خطی تحت تأثیر قرار نگیرد، null
برمیگرداند.
// Logs the boolean condition strikethrough setting for each conditional format // rule on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const strikethrough = rule.getBooleanCondition().getStrikethrough(); Logger.log(`Strikethrough: ${strikethrough}`); }
بازگشت
Boolean
- چه شرط بولی در متن باشد یا نه، یا اگر خط خطی تحت تأثیر قرار نگیرد، null
get Underline()
اگر این شرط بولی زیر متن زیر خط بکشد true
برمیگرداند و اگر این شرط بولی خط زیر را از متن حذف کند، false
را برمیگرداند. در صورتی که خط زیر تاثیری نداشته باشد، null
برمیگرداند.
// Logs the boolean condition underline setting for each conditional format rule // on a sheet. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); for (const rule of rules) { const underline = rule.getBooleanCondition().getUnderline(); Logger.log(`Underline: ${underline}`); }
بازگشت
Boolean
- اینکه آیا شرط بولی زیر متن زیر خط میکشد یا نه، یا اگر زیرخطگذاری تأثیری نداشته باشد، null
.