גישה לתנאים בוליאניים ב-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
אם
אין השפעה על קו תחתון