این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class BooleanCondition

به شرایط بولی در 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` برمی‌گرداند.

روش های منسوخ شده

روش	نوع برگشت	توضیح مختصر
`getBackground()`	`String`	رشته رنگ پس زمینه را برای این شرط بولی دریافت می کند.
`getFontColor()`	`String`	رشته رنگ فونت را برای این شرط بولی دریافت می کند.

مستندات دقیق

`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 .

روش های منسوخ شده

`getBackground()`

منسوخ. با 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().getBackground();
  Logger.log("The background color for rule %s is %s", i, color);
}

برگشت

String - رشته رنگ پس زمینه، یا اگر برای این شرط تنظیم نشده باشد، null .

`getFontColor()`

منسوخ. با 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().getFontColor();
  Logger.log("The font color for rule %s is %s", i, color);
}

برگشت

String - رشته رنگ فونت، یا اگر برای این شرط تنظیم نشده باشد، null .