גישה לתנאים של מעבר צבעים הדרגתי ב-ConditionalFormatRuleApis
.
כל כלל של עיצוב מותנה יכול להכיל תנאי אחד הדרגתי. תנאי הדרגתי מוגדר על ידי שלוש נקודות לאורך סולם מספרים (min, mid ו-max), שבכל אחת מהן יש צבע, ערך ו-InterpolationType
. התוכן של התא מושווה לערכים בסולם המספרים, והצבע שחל על התא עובר אינטרפולציה על סמך הקרבה של תוכן התא לנקודות של השיפוע מינימום, אמצע ומקסימום.
// Logs all the information inside gradient conditional format rules on a sheet. // The below snippet assumes all colors have ColorType.RGB. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var gradient = rules[i].getGradientCondition(); Logger.log("The conditional format gradient information for rule %d:\n MinColor %s, MinType %s, MinValue %s, \n MidColor %s, MidType %s, MidValue %s, \n MaxColor %s, MaxType %s, MaxValue %s \n", i, gradient.getMinColorObject().asRgbColor().asHexString(), gradient.getMinType(), gradient.getMinValue(), gradient.getMidColorObject().asRgbColor().asHexString(), gradient.getMidType(), gradient.getMidValue(), gradient.getMaxColorObject().asRgbColor().asHexString(), gradient.getMaxType(), gradient.getMaxValue()); }
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
getMaxColorObject() | Color | הפונקציה מקבלת את הגדרת הצבע עבור הערך המקסימלי של תנאי ההדרגתיות הזה. |
getMaxType() | InterpolationType | הפונקציה מקבלת את סוג האינטרפולציה של הערך המקסימלי של תנאי ההדרגתיות הזה. |
getMaxValue() | String | הפונקציה מקבלת את הערך המקסימלי של תנאי ההדרגתיות הזה. |
getMidColorObject() | Color | הפונקציה מקבלת את הגדרת הצבע עבור ערך נקודת האמצע של תנאי ההדרגתיות הזה. |
getMidType() | InterpolationType | הפונקציה מקבלת את סוג האינטרפולציה של ערך נקודת האמצע של תנאי ההדרגתיות הזה. |
getMidValue() | String | הפונקציה מקבלת את הערך של נקודת האמצע של תנאי ההדרגתיות הזה. |
getMinColorObject() | Color | הפונקציה מקבלת את הגדרת הצבע עבור הערך המינימלי של תנאי ההדרגתיות הזה. |
getMinType() | InterpolationType | הפונקציה מקבלת את סוג האינטרפולציה של הערך המינימלי של תנאי ההדרגתיות הזה. |
getMinValue() | String | הפונקציה מקבלת את הערך המינימלי של תנאי ההדרגתיות הזה. |
תיעוד מפורט
getMaxColorObject()
הפונקציה מקבלת את הגדרת הצבע עבור הערך המקסימלי של תנאי ההדרגתיות הזה. הפונקציה מחזירה את הערך null
אם
הצבע לא הוגדר.
החזרות
Color
– הצבע שהוגדר עבור הערך המקסימלי של תנאי ההדרגתיות הזה או null
.
getMaxType()
הפונקציה מקבלת את סוג האינטרפולציה של הערך המקסימלי של תנאי ההדרגתיות הזה. מחזירה null
אם לא הוגדר הסוג המקסימלי של ההדרגתיות.
החזרות
InterpolationType
– סוג האינטרפולציה עבור הערך המקסימלי של תנאי ההדרגתיות הזה או null
getMaxValue()
הפונקציה מקבלת את הערך המקסימלי של תנאי ההדרגתיות הזה. הפונקציה מחזירה מחרוזת ריקה אם InterpolationType
הוא MAX
או אם לא הוגדר הערך המקסימלי.
החזרות
String
– הערך המקסימלי אם הוא מצוין או מחרוזת ריקה
getMidColorObject()
הפונקציה מקבלת את הגדרת הצבע עבור ערך נקודת האמצע של תנאי ההדרגתיות הזה. הפונקציה מחזירה את הערך null
אם
הצבע לא הוגדר.
החזרות
Color
– הצבע המוגדר עבור ערך נקודת האמצע של תנאי ההדרגתיות הזה או null
.
getMidType()
הפונקציה מקבלת את סוג האינטרפולציה של ערך נקודת האמצע של תנאי ההדרגתיות הזה. הפונקציה מחזירה את הערך null
אם לא הוגדר סוג אמצע ההדרגתיות.
החזרות
InterpolationType
– סוג האינטרפולציה עבור הערך של נקודת האמצע של תנאי ההדרגתיות הזה או null
getMidValue()
הפונקציה מקבלת את הערך של נקודת האמצע של תנאי ההדרגתיות הזה. מחזירה מחרוזת ריקה אם לא הוגדר ערך אמצע של ההדרגתיות.
החזרות
String
- ערך נקודת האמצע או מחרוזת ריקה
getMinColorObject()
הפונקציה מקבלת את הגדרת הצבע עבור הערך המינימלי של תנאי ההדרגתיות הזה. הפונקציה מחזירה את הערך null
אם
הצבע לא הוגדר.
החזרות
Color
– הצבע שהוגדר עבור הערך המינימלי של תנאי ההדרגתיות הזה או null
.
getMinType()
הפונקציה מקבלת את סוג האינטרפולציה של הערך המינימלי של תנאי ההדרגתיות הזה. מחזירה null
אם לא הוגדר סוג המינימום של ההדרגתיות.
החזרות
InterpolationType
– סוג האינטרפולציה עבור הערך המינימלי של תנאי ההדרגתיות הזה או null
getMinValue()
הפונקציה מקבלת את הערך המינימלי של תנאי ההדרגתיות הזה. מחזירה מחרוזת ריקה אם InterpolationType
הוא MIN
או אם לא הוגדר ערך
מינימלי.
החזרות
String
– הערך המינימלי אם צוין או מחרוזת ריקה