Class GradientCondition

GradientCondition

In ConditionalFormatRuleApis können Sie auf Bedingungen für Farbverläufe zugreifen. Jede bedingte Formatierungsregel kann eine einzelne Farbverlaufsbedingung enthalten. Eine Farbverlaufsbedingung wird durch drei Punkte entlang einer Zahlenskala (Min., Mitte und Max.) definiert, die jeweils eine Farbe, einen Wert und eine InterpolationType haben. Der Inhalt einer Zelle wird mit den Werten in der Zahlenskala verglichen und die Farbe, die auf die Zelle angewendet wird, wird basierend auf der Nähe des Zelleninhalts zu den Mindest-, Mittel- und Höchstpunkten der Farbverlaufsbedingung 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 Farbverlaufsbedingung festgelegt ist.
getMaxType()InterpolationTypeDer Interpolationstyp für den Maximalwert dieser Farbverlaufsbedingung.
getMaxValue()StringRuft den Höchstwert dieser Gradientenbedingung ab.
getMidColorObject()ColorRuft die Farbe ab, die für den Mittelwert dieser Farbverlaufsbedingung festgelegt wurde.
getMidType()InterpolationTypeDer Interpolationstyp für den Mittelwert dieser Gradientenbedingung.
getMidValue()StringRuft den Mittelwert dieser Gradientenbedingung ab.
getMinColorObject()ColorRuft die Farbe ab, die für den Mindestwert dieser Farbverlaufsbedingung festgelegt ist.
getMinType()InterpolationTypeDer Interpolationstyp für den Mindestwert dieser Gradientenbedingung.
getMinValue()StringRuft den Mindestwert dieser Farbverlaufsbedingung ab.

Detaillierte Dokumentation

getMaxColorObject()

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

Rückflug

Color: Die Farbe, die für den Höchstwert dieser Farbverlaufsbedingung festgelegt ist, oder null.

getMaxType()

Der Interpolationstyp für den Maximalwert dieser Farbverlaufsbedingung. Wird null zurückgegeben, wenn der maximale Farbverlaufstyp nicht festgelegt wurde.

Rückflug

InterpolationType: der Interpolationstyp für den Höchstwert dieser Farbverlaufsbedingung oder null

getMaxValue()

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

Rückflug

String – der angegebene Höchstwert oder ein leerer String

getMidColorObject()

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

Rückflug

Color: Die Farbe, die für den Mittelwert dieser Farbverlaufsbedingung festgelegt ist, oder null.

getMidType()

Der Interpolationstyp für den Mittelwert dieser Gradientenbedingung. Gibt null zurück, wenn der Typ des Farbverlaufsmittelpunkts nicht festgelegt wurde.

Rückflug

InterpolationType: Der Interpolationstyp für den Mittelwert dieser Farbverlaufsbedingung oder null

getMidValue()

Ruft den Mittelwert 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 Farbe, die für den Mindestwert dieser Farbverlaufsbedingung oder null festgelegt ist.

getMinType()

Der Interpolationstyp für den Mindestwert dieser Gradientenbedingung. Gibt null zurück, wenn der Mindesttyp des Farbverlaufs nicht festgelegt wurde.

Rückflug

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

getMinValue()

Ruft den Mindestwert dieser Farbverlaufsbedingung 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