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