Class GradientCondition

GradientCondition

גישה לתנאים של הדרגתיות (צבע) ב-ConditionalFormatRuleApis. כל כלל של פורמט מותנה יכול להכיל תנאי אחד של הדרגתיות. תנאי של הדרגתי הוא מוגדר לפי שלוש נקודות לאורך סולם מספרים (מינימום, אמצע ומקסימום), שלכל אחת מהן יש צבע, ו-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 – הערך המינימלי אם צוין או מחרוזת ריקה

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