Class GradientCondition

GradientCondition

Zugriff auf Bedingungen für den Farbverlauf (Farbverlauf) in ConditionalFormatRuleApis. Jede Regel für die bedingte Formatierung kann eine einzelne Gradientenbedingung enthalten. Eine Gradientenbedingung wird durch drei Punkte entlang einer Zahlenskala (Min, Mid 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 auf die Zelle angewendete Farbe wird basierend auf der Nähe des Zelleninhalts zum Min., Mittelwert und Höchstwert der Gradientenbedingung interpoliert.

// Logs all the information inside gradient conditional format rules on a sheet.
// The below snippet assumes all colors have ColorType.RGB.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var gradient = rules[i].getGradientCondition();
  Logger.log("The conditional format gradient information for rule %d:\n
    MinColor %s, MinType %s, MinValue %s, \n
    MidColor %s, MidType %s, MidValue %s, \n
    MaxColor %s, MaxType %s, MaxValue %s \n", i,
    gradient.getMinColorObject().asRgbColor().asHexString(),
    gradient.getMinType(), gradient.getMinValue(),
    gradient.getMidColorObject().asRgbColor().asHexString(),
    gradient.getMidType(), gradient.getMidValue(),
    gradient.getMaxColorObject().asRgbColor().asHexString(),
    gradient.getMaxType(), gradient.getMaxValue());
}

Methoden

MethodeRückgabetypKurzbeschreibung
getMaxColorObject()ColorRuft den Farbsatz für den Maximalwert dieser Farbverlaufsbedingung ab.
getMaxType()InterpolationTypeRuft den Interpolationstyp für den Maximalwert dieser Gradientenbedingung ab.
getMaxValue()StringRuft den Maximalwert dieser Gradientenbedingung ab.
getMidColorObject()ColorRuft den Farbsatz für den Mittelpunkt dieser Farbverlaufsbedingung ab.
getMidType()InterpolationTypeRuft den Interpolationstyp für den Mittelpunktwert dieser Gradientenbedingung ab.
getMidValue()StringRuft den Mittelpunktwert dieser Gradientenbedingung ab.
getMinColorObject()ColorRuft den Farbsatz für den Mindestwert dieser Farbverlaufsbedingung ab.
getMinType()InterpolationTypeRuft den Interpolationstyp für den Mindestwert dieser Gradientenbedingung ab.
getMinValue()StringRuft den Minimalwert dieser Gradientenbedingung ab.

Detaillierte Dokumentation

getMaxColorObject()

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

Return

Color: Der Farbsatz für den Maximalwert dieser Farbverlaufsbedingung oder null.


getMaxType()

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

Return

InterpolationType: der Interpolationstyp für den Maximalwert dieser Gradientenbedingung oder null


getMaxValue()

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

Return

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


getMidColorObject()

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

Return

Color: Die für den Mittelpunkt dieser Farbverlaufsbedingung oder null festgelegte Farbe.


getMidType()

Ruft den Interpolationstyp für den Mittelpunktwert dieser Gradientenbedingung ab. Gibt null zurück, wenn der Mid-Type des Farbverlaufs nicht festgelegt wurde.

Return

InterpolationType: der Interpolationstyp für den Mittelpunkt 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.

Return

String – der Mittelpunktwert oder ein leerer String


getMinColorObject()

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

Return

Color: Der Farbsatz für den Mindestwert dieser Farbverlaufsbedingung oder von null.


getMinType()

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

Return

InterpolationType: der Interpolationstyp für den Minimalwert dieser Gradientenbedingung oder null


getMinValue()

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

Return

String: Der Minimalwert, falls angegeben, oder ein leerer String

Verworfene Methoden