דף זה תורגם על ידי Cloud Translation API.

Class 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` אם התנאי הבוליאני מסיר מהטקסט קו תחתון.

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

שיטה	סוג הערך המוחזר	תיאור קצר
`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()`

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

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

`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 אם לא הוגדר תנאי הזה.