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|nullהפונקציה מחזירה את הצבע שמוגדר לערך המקסימלי של תנאי הגרדיאנט הזה.
getMaxType()InterpolationType|nullמחזירה את סוג האינטרפולציה של הערך המקסימלי של תנאי הגרדיאנט הזה.
getMaxValue()Stringמחזירה את הערך המקסימלי של תנאי הגרדיאנט הזה.
getMidColorObject()Color|nullמחזירה את הצבע שהוגדר לערך נקודת האמצע של תנאי הגרדיאנט הזה.
getMidType()InterpolationType|nullמחזירה את סוג האינטרפולציה של ערך נקודת האמצע של תנאי הגרדיאנט הזה.
getMidValue()Stringמחזירה את ערך נקודת האמצע של תנאי הגרדיאנט הזה.
getMinColorObject()Color|nullהפונקציה מחזירה את הצבע שמוגדר לערך המינימלי של תנאי הגרדיאנט הזה.
getMinType()InterpolationType|nullמחזירה את סוג האינטרפולציה של הערך המינימלי של תנאי הגרדיאנט הזה.
getMinValue()Stringמחזירה את הערך המינימלי של תנאי הגרדיאנט הזה.

תיעוד מפורט

getMaxColorObject()

הפונקציה מחזירה את הצבע שמוגדר לערך המקסימלי של תנאי הגרדיאנט הזה. הפונקציה מחזירה null אם הצבע לא הוגדר.

חזרה

Color|null – הצבע שמוגדר לערך המקסימלי של תנאי המעבר הזה או null.


getMaxType()

מחזירה את סוג האינטרפולציה של הערך המקסימלי של תנאי הגרדיאנט הזה. הפונקציה מחזירה null אם לא הוגדר סוג מקסימלי של מעבר צבעים.

חזרה

InterpolationType|null – סוג האינטרפולציה של הערך המקסימלי של תנאי הגרדיאנט הזה או null.


getMaxValue()

מחזירה את הערך המקסימלי של תנאי הגרדיאנט הזה. הפונקציה מחזירה מחרוזת ריקה אם InterpolationType הוא MAX או אם לא הוגדר ערך מקסימלי.

חזרה

String — הערך המקסימלי אם הוא מצוין, או מחרוזת ריקה.


getMidColorObject()

מחזירה את הצבע שהוגדר לערך נקודת האמצע של תנאי הגרדיאנט הזה. הפונקציה מחזירה null אם הצבע לא הוגדר.

חזרה

Color|null – הצבע שמוגדר לערך נקודת האמצע של תנאי הגרדיאנט הזה או null.


getMidType()

מחזירה את סוג האינטרפולציה של ערך נקודת האמצע של תנאי הגרדיאנט הזה. הפונקציה מחזירה את הערך null אם לא הוגדר סוג אמצע הגרדיאנט.

חזרה

InterpolationType|null — סוג האינטרפולציה לערך נקודת האמצע של תנאי הגרדיאנט הזה או null.


getMidValue()

מחזירה את ערך נקודת האמצע של תנאי הגרדיאנט הזה. הפונקציה מחזירה מחרוזת ריקה אם לא הוגדר ערך אמצעי של המעבר.

חזרה

String — ערך נקודת האמצע או מחרוזת ריקה.


getMinColorObject()

הפונקציה מחזירה את הצבע שמוגדר לערך המינימלי של תנאי הגרדיאנט הזה. הפונקציה מחזירה null אם הצבע לא הוגדר.

חזרה

Color|null – הצבע שמוגדר לערך המינימלי של תנאי הגרדיאנט הזה או null.


getMinType()

מחזירה את סוג האינטרפולציה של הערך המינימלי של תנאי הגרדיאנט הזה. הפונקציה מחזירה את הערך null אם לא הוגדר סוג המינימום של המעבר.

חזרה

InterpolationType|null – סוג האינטרפולציה לערך המינימלי של תנאי הגרדיאנט הזה או null.


getMinValue()

מחזירה את הערך המינימלי של תנאי הגרדיאנט הזה. הפונקציה מחזירה מחרוזת ריקה אם InterpolationType הוא MIN או אם לא הוגדר ערך מינימלי.

חזרה

String – הערך המינימלי אם הוא צוין, או מחרוזת ריקה.

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