Class GradientCondition

Bedingung

In ConditionalFormatRuleApis auf Farbverlaufsbedingungen zugreifen Jede Regel für die bedingte Formatierung kann eine einzelne Bedingung für den Farbverlauf enthalten. Eine Gradientenbedingung wird durch drei Punkte auf einer Zahlenskala (Min., Mittelwert und Max.) definiert, die jeweils eine Farbe, einen Wert und ein InterpolationType haben. 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 Minimal-, Mittel- und Maximalpunkten der Gradientenbedingung 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

Methode	Rückgabetyp	Kurzbeschreibung
getMaxColorObject()	Color	Ruft die Farbe ab, die für den Höchstwert dieser Gradientenbedingung festgelegt ist.
getMaxType()	InterpolationType	Ruft den Interpolationstyp für den Maximalwert dieser Gradientenbedingung ab.
getMaxValue()	String	Ruft den Höchstwert dieser Gradientenbedingung ab.
getMidColorObject()	Color	Ruft die Farbe ab, die für den Mittelwert dieser Gradientenbedingung festgelegt ist.
getMidType()	InterpolationType	Ruft den Interpolationstyp für den Mittelpunktwert dieser Gradientenbedingung ab.
getMidValue()	String	Ruft den Mittelpunktwert dieser Gradientenbedingung ab.
getMinColorObject()	Color	Ruft die Farbe ab, die für den Mindestwert dieser Farbverlaufsbedingung festgelegt ist.
getMinType()	InterpolationType	Ruft den Interpolationstyp für den Mindestwert dieser Gradientenbedingung ab.
getMinValue()	String	Ruft den Mindestwert dieser Gradientenbedingung ab.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getMaxColor()	String	Ruft die Farbe ab, die für den Höchstwert dieser Gradientenbedingung festgelegt ist.
getMidColor()	String	Ruft die Farbe ab, die für den Mittelwert dieser Gradientenbedingung festgelegt ist.
getMinColor()	String	Ruft die Farbe ab, die für den Mindestwert dieser Farbverlaufsbedingung festgelegt ist.

Detaillierte Dokumentation

getMaxColorObject()

Ruft die Farbe ab, die für den Höchstwert dieser Gradientenbedingung festgelegt ist. Gibt null zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

Color: Die für den Höchstwert dieser Gradientenbedingung oder null festgelegte Farbe.

---

getMaxType()

Ruft den Interpolationstyp für den Maximalwert dieser Gradientenbedingung ab. Gibt null zurück, wenn der maximale Typ des Farbverlaufs nicht festgelegt wurde.

Rückflug

InterpolationType: Der Interpolationstyp für den Höchstwert dieser Gradientenbedingung oder null.

---

getMaxValue()

Ruft den Höchstwert dieser Gradientenbedingung ab. Gibt einen leeren String zurück, wenn InterpolationType gleich MAX ist oder der Maximalwert nicht festgelegt wurde.

Rückflug

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

---

getMidColorObject()

Ruft die Farbe ab, die für den Mittelwert dieser Gradientenbedingung festgelegt ist. Gibt null zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

Color: Die für den Mittelwert dieser Gradientenbedingung oder null festgelegte Farbe.

---

getMidType()

Ruft den Interpolationstyp für den Mittelpunktwert dieser Gradientenbedingung ab. Gibt null zurück, wenn der Typ für die Mitte des Farbverlaufs nicht festgelegt wurde.

Rückflug

InterpolationType: Der Interpolationstyp für den Mittelpunktwert dieser Gradientenbedingung oder null.

---

getMidValue()

Ruft den Mittelpunktwert dieser Gradientenbedingung ab. Gibt einen leeren String zurück, wenn der Mittelwert des Farbverlaufs nicht festgelegt wurde.

Rückflug

String: Der Mittelwert oder ein leerer String.

---

getMinColorObject()

Ruft die Farbe ab, die für den Mindestwert dieser Farbverlaufsbedingung festgelegt ist. Gibt null zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

Color: Die für den Mindestwert dieser Bedingung für den Farbverlauf oder null festgelegte Farbe.

---

getMinType()

Ruft den Interpolationstyp für den Mindestwert dieser Gradientenbedingung ab. Gibt null zurück, wenn der Typ für das Gradientenminimum nicht festgelegt wurde.

Rückflug

InterpolationType: Der Interpolationstyp für den Mindestwert dieser Gradientenbedingung oder null.

---

getMinValue()

Ruft den Mindestwert dieser Gradientenbedingung ab. Gibt einen leeren String zurück, wenn InterpolationType MIN ist oder der Mindestwert nicht festgelegt wurde.

Rückflug

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

Eingestellte Methoden

getMaxColor()

Veraltet. Ersetzt durch getMaxColorObject()

Ruft die Farbe ab, die für den Höchstwert dieser Gradientenbedingung festgelegt ist. Gibt einen leeren String zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

String: Die für den Höchstwert dieser Farbverlaufsbedingung festgelegte Farbe oder ein leerer String.

---

getMidColor()

Veraltet. Ersetzt durch getMidColorObject()

Ruft die Farbe ab, die für den Mittelwert dieser Gradientenbedingung festgelegt ist. Gibt einen leeren String zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

String: Die für den Mittelwert dieser Bedingung mit Farbverlauf festgelegte Farbe oder ein leerer String.

---

getMinColor()

Veraltet. Ersetzt durch getMinColorObject()

Ruft die Farbe ab, die für den Mindestwert dieser Farbverlaufsbedingung festgelegt ist. Gibt einen leeren String zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

String: Die für den Mindestwert dieser Bedingung für den Farbverlauf festgelegte Farbe oder ein leerer String.