Class BooleanCondition

BooleanCondition

גישה לתנאים בוליאניים ב-ConditionalFormatRules. כל אחד כלל של פורמט מותנה יכול להכיל תנאי בוליאני אחד. התנאי הבוליאני עצמו מכיל קריטריונים בוליאניים (עם ערכים) והגדרות עיצוב. הקריטריונים נבדקים לעומת התוכן של תא שמוביל לערך 'true' או 'false'. אם תוצאת הפונקציה של קריטריון היא true, הגדרות העיצוב של התנאי חלות על התא.

שיטות

שיטהסוג הערך המוחזרתיאור קצר
getBackgroundObject()Colorהפונקציה מקבלת את צבע הרקע של התנאי הבוליאני הזה.
getBold()Booleanהפונקציה מחזירה את הערך true אם התנאי הבוליאני מדגיש את הטקסט ומחזיר את הערך false אם תנאי בוליאני מסיר טקסט מודגש מהטקסט.
getCriteriaType()BooleanCriteriaהפונקציה מקבלת את סוג הקריטריונים של הכלל כפי שמוגדר ב-enum 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()

הפונקציה מקבלת את סוג הקריטריונים של הכלל כפי שמוגדר ב-enum 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 אם אין השפעה על קו תחתון

שיטות שהוצאו משימוש