Class BooleanCondition

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 إذا فإن هذا الشرط المنطقي يزيل التسطير من النص.

الوثائق التفصيلية

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 إذا لا يتأثر الخط السفلي

طرق متوقّفة نهائيًا