Class BooleanCondition

شرط بولی

به شرط‌های بولی در ConditionalFormatRules دسترسی داشته باشید. هر قانون قالب‌بندی شرطی ممکن است شامل یک شرط بولی باشد. شرط بولی خود شامل یک معیار بولی (همراه با مقادیر) و تنظیمات قالب‌بندی است. معیارها در برابر محتوای یک سلول ارزیابی می‌شوند و منجر به مقدار true یا false می‌شوند. اگر معیار true ارزیابی شود، تنظیمات قالب‌بندی شرط روی سلول اعمال می‌شود.

روش‌ها

روش نوع بازگشتی شرح مختصر
get Background Object() Color |null رنگ پس‌زمینه را برای این شرط بولی برمی‌گرداند.
get Bold() Boolean|null اگر این شرط بولی متن را پررنگ کند، true را برمی‌گرداند و اگر این شرط بولی، پررنگ شدن متن را حذف کند، false را برمی‌گرداند.
get Criteria Type() Boolean Criteria نوع معیار قاعده را همانطور که در شمارش Boolean Criteria تعریف شده است، برمی‌گرداند.
get Criteria Values() Object[] آرایه‌ای از آرگومان‌ها را برای معیارهای قاعده دریافت می‌کند.
get Font Color Object() Color |null رنگ فونت را برای این شرط بولی برمی‌گرداند.
get Italic() Boolean|null اگر این شرط بولی متن را کج (italic) کند، true را برمی‌گرداند و اگر این شرط بولی، حروف کج (italic) را از متن حذف کند، false را برمی‌گرداند.
get Strikethrough() Boolean|null اگر این شرط بولی متن را خط بزند، true را برمی‌گرداند و اگر این شرط بولی، خط خورده را از متن حذف کند، false را برمی‌گرداند.
get Underline() Boolean|null اگر این شرط بولی متن را زیرخط‌دار کند، true را برمی‌گرداند و اگر این شرط بولی زیرخط‌دار را از متن حذف کند، false را برمی‌گرداند.

مستندات دقیق

getBackgroundObject()

رنگ پس‌زمینه را برای این شرط بولی برمی‌گرداند. در صورت عدم تنظیم، 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 — رنگ پس‌زمینه، یا اگر برای این شرط تنظیم نشده باشد، null .

getBold()

اگر این شرط بولی متن را پررنگ کند، مقدار 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 — اینکه آیا شرط بولی متن را پررنگ می‌کند یا خیر، یا اگر پررنگ کردن بی‌تأثیر باشد، null

getCriteriaType()

نوع معیار قاعده را همانطور که در enum BooleanCriteria تعریف شده است، دریافت می‌کند. برای دریافت آرگومان‌های معیار، getCriteriaValues() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قاعده قالب‌بندی شرطی، به ConditionalFormatRuleBuilder.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}`);
  }
});

بازگشت

BooleanCriteria - نوع معیارهای قالب‌بندی شرطی.

getCriteriaValues()

آرایه‌ای از آرگومان‌ها را برای معیارهای قانون دریافت می‌کند. برای دریافت نوع معیار، getCriteriaType() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون قالب‌بندی شرطی، به ConditionalFormatRuleBuilder.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...() مربوط به کلاس ConditionalFormatRuleBuilder مطابقت دارد.

getFontColorObject()

رنگ فونت را برای این شرط بولی برمی‌گرداند. در صورت عدم تنظیم، 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 — رنگ فونت، یا اگر برای این شرط تنظیم نشده باشد، null .

getItalic()

اگر این شرط بولی متن را کج (italic) کند، مقدار true و اگر این شرط بولی، حروف کج (italic) را از متن حذف کند، مقدار false را برمی‌گرداند. اگر حروف کج (italic) تغییری نکنند، 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 — اینکه آیا شرط بولی متن را کج می‌کند یا نه، یا اگر کج کردن بی‌تأثیر باشد، null است.

getStrikethrough()

اگر این شرط بولی متن را خط بزند، مقدار 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 — اینکه آیا شرط بولی از متن عبور می‌کند یا خیر، یا اگر خط‌خوردگی بی‌تأثیر باشد، null

getUnderline()

اگر این شرط بولی متن را زیرخط‌دار کند، مقدار 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 — اینکه آیا شرط Boolean متن را زیرخط‌دار می‌کند یا خیر، یا null اگر زیرخط‌دار بودن متن بی‌تأثیر باشد.

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