Class GradientCondition

GradientCondition

Auf Bedingungen für Farbverläufe kann in ConditionalFormatRuleApis zugegriffen werden. Jede Regel für die bedingte Formatierung kann eine einzelne Bedingung für Farbverläufe enthalten. Eine Bedingung für Farbverläufe wird durch drei Punkte auf einer Zahlenskala definiert (Minimum, Mittelpunkt und Maximum). Jeder Punkt hat eine Farbe, einen Wert und einen InterpolationType. Der Inhalt einer Zelle wird mit den Werten auf der Zahlenskala verglichen. Die auf die Zelle angewendete Farbe wird basierend auf der Nähe des Zellinhalts zu den Punkten für Minimum, Mittelpunkt und Maximum der Bedingung für Farbverläufe interpoliert. 

// 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}`);
}

Methoden

MethodeRückgabetypKurzbeschreibung
getMaxColorObject()Color|nullRuft die Farbe ab, die für den Höchstwert dieser Bedingung für Farbverläufe festgelegt wurde.
getMaxType()InterpolationType|nullRuft den Interpolationstyp für den Höchstwert dieser Bedingung für Farbverläufe ab.
getMaxValue()StringRuft den Höchstwert dieser Bedingung für Farbverläufe ab.
getMidColorObject()Color|nullRuft die Farbe ab, die für den Mittelpunktwert dieser Bedingung für Farbverläufe festgelegt wurde.
getMidType()InterpolationType|nullRuft den Interpolationstyp für den Mittelpunktwert dieser Bedingung für Farbverläufe ab.
getMidValue()StringRuft den Mittelpunktwert dieser Bedingung für Farbverläufe ab.
getMinColorObject()Color|nullRuft die Farbe ab, die für den Mindestwert dieser Bedingung für Farbverläufe festgelegt wurde.
getMinType()InterpolationType|nullRuft den Interpolationstyp für den Mindestwert dieser Bedingung für Farbverläufe ab.
getMinValue()StringRuft den Mindestwert dieser Bedingung für Farbverläufe ab.

Detaillierte Dokumentation

getMaxColorObject()

Ruft die Farbe ab, die für den Höchstwert dieser Bedingung für Farbverläufe festgelegt wurde. Gibt null zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

Color|null : Die Farbe, die für den Höchstwert dieser Bedingung für Farbverläufe festgelegt wurde, oder null.

getMaxType()

Ruft den Interpolationstyp für den Höchstwert dieser Bedingung für Farbverläufe ab. Gibt null zurück, wenn der Höchstwerttyp für den Farbverlauf nicht festgelegt wurde.

Rückflug

InterpolationType|null : Der Interpolationstyp für den Höchstwert dieser Bedingung für Farbverläufe oder null.

getMaxValue()

Ruft den Höchstwert dieser Bedingung für Farbverläufe ab. Gibt einen leeren String zurück, wenn der InterpolationType MAX ist oder wenn der Höchstwert nicht festgelegt wurde.

Rückflug

String : Der Höchstwert, falls angegeben, oder ein leerer String.

getMidColorObject()

Ruft die Farbe ab, die für den Mittelpunktwert dieser Bedingung für Farbverläufe festgelegt wurde. Gibt null zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

Color|null : Die Farbe, die für den Mittelpunktwert dieser Bedingung für Farbverläufe festgelegt wurde, oder null.

getMidType()

Ruft den Interpolationstyp für den Mittelpunktwert dieser Bedingung für Farbverläufe ab. Gibt null zurück, wenn der Mittelpunktwerttyp für den Farbverlauf nicht festgelegt wurde.

Rückflug

InterpolationType|null : Der Interpolationstyp für den Mittelpunktwert dieser Bedingung für Farbverläufe oder null.

getMidValue()

Ruft den Mittelpunktwert dieser Bedingung für Farbverläufe ab. Gibt einen leeren String zurück, wenn der Mittelpunktwert für den Farbverlauf nicht festgelegt wurde.

Rückflug

String : Der Mittelpunktwert oder ein leerer String.

getMinColorObject()

Ruft die Farbe ab, die für den Mindestwert dieser Bedingung für Farbverläufe festgelegt wurde. Gibt null zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

Color|null : Die Farbe, die für den Mindestwert dieser Bedingung für Farbverläufe festgelegt wurde, oder null.

getMinType()

Ruft den Interpolationstyp für den Mindestwert dieser Bedingung für Farbverläufe ab. Gibt null zurück, wenn der Mindestwerttyp für den Farbverlauf nicht festgelegt wurde.

Rückflug

InterpolationType|null : Der Interpolationstyp für den Mindestwert dieser Bedingung für Farbverläufe oder null.

getMinValue()

Ruft den Mindestwert dieser Bedingung für Farbverläufe ab. Gibt einen leeren String zurück, wenn der InterpolationType MIN ist oder wenn der Mindestwert nicht festgelegt wurde.

Rückflug

String : Der Mindestwert, falls angegeben, oder ein leerer String.

Veraltete Methoden