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