Class BooleanCondition

شرط بولی

به شرط‌های بولی در Conditional Format Rules دسترسی داشته باشید. هر قانون قالب‌بندی شرطی ممکن است شامل یک شرط بولی باشد. شرط بولی خود شامل یک معیار بولی (همراه با مقادیر) و تنظیمات قالب‌بندی است. معیار در برابر محتوای یک سلول ارزیابی می‌شود و منجر به مقدار 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 را برمی‌گرداند.

مستندات دقیق

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

get Italic()

اگر این شرط بولی متن را کج (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 است.

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

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