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

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