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

MethodeRückgabetypKurzbeschreibung
getMaxColorObject()ColorRuft die Farbe ab, die für den Höchstwert dieser Gradientenbedingung festgelegt ist.
getMaxType()InterpolationTypeRuft den Interpolationstyp für den Maximalwert dieser Gradientenbedingung ab.
getMaxValue()StringRuft den Höchstwert dieser Gradientenbedingung ab.
getMidColorObject()ColorRuft die Farbe ab, die für den Mittelwert dieser Gradientenbedingung festgelegt ist.
getMidType()InterpolationTypeRuft den Interpolationstyp für den Mittelpunktwert dieser Gradientenbedingung ab.
getMidValue()StringRuft den Mittelpunktwert dieser Gradientenbedingung ab.
getMinColorObject()ColorRuft die Farbe ab, die für den Mindestwert dieser Farbverlaufsbedingung festgelegt ist.
getMinType()InterpolationTypeRuft den Interpolationstyp für den Mindestwert dieser Gradientenbedingung ab.
getMinValue()StringRuft den Mindestwert dieser Gradientenbedingung ab.

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