Class GradientCondition

GradientCondition

תנאי טווח צבעים (gradient) נמצאים בקטע ConditionalFormatRuleApis. כל כלל עיצוב מותנה יכול להכיל רק תנאי שינוי הדרגתי אחד. תנאי שינוי הדרגתי מוגדר על ידי שלוש נקודות בסולם מספרים (מינימום, אמצע ומקסימום), לכל אחת מהן יש צבע, ערך ו-InterpolationType. התוכן של התא מושווה לערכים בסולם המספרים, והצבע שיוחל על התא ינוטרל על סמך הקרבה של תוכן התא לנקודות המינימום, האמצעי והמקסימום של תנאי הדרגתיות. 

// Logs all the information inside gradient conditional format rules on a sheet.
// The below snippet assumes all colors have ColorType.RGB.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (let i = 0; i < rules.length; i++) {
  const gradient = rules[i].getGradientCondition();

  const minColor = gradient.getMinColorObject().asRgbColor().asHexString();
  const minType = gradient.getMinType();
  const minValue = gradient.getMinValue();
  const midColor = gradient.getMidColorObject().asRgbColor().asHexString();
  const midType = gradient.getMidType();
  const midValue = gradient.getMidValue();
  const maxColor = gradient.getMaxColorObject().asRgbColor().asHexString();
  const maxType = gradient.getMaxType();
  const maxValue = gradient.getMaxValue();

  Logger.log(`The conditional format gradient information for rule ${i}:
    MinColor ${minColor}, MinType ${minType}, MinValue ${minValue},
    MidColor ${midColor}, MidType ${midType}, MidValue ${midValue},
    MaxColor ${maxColor}, MaxType ${maxType}, MaxValue ${maxValue}`);
}

Methods

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

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