Class GradientCondition

GradientCondition

גישה לתנאים של מעבר צבעים הדרגתי ב-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 – הערך המינימלי אם צוין או מחרוזת ריקה

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