Diese Seite wurde von der Cloud Translation API übersetzt.

Class 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

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

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getMaxColor()`	`String`	Ruft die Farbe ab, die für den Höchstwert dieser Farbverlaufsbedingung festgelegt ist.
`getMidColor()`	`String`	Ruft die Farbe ab, die für den Mittelwert dieser Farbverlaufsbedingung festgelegt wurde.
`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 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

`getMaxColor()`

Veraltet. Ersetzt durch getMaxColorObject()

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

Rückflug

String: Die Farbe, die für den Höchstwert dieser Farbverlaufsbedingung festgelegt ist, oder ein leerer String.

`getMidColor()`

Veraltet. Ersetzt durch getMidColorObject()

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

Rückflug

String: Die Farbe, die für den Mittelwert dieser Farbverlaufsbedingung festgelegt ist, 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 Farbe, die für den Mindestwert dieser Farbverlaufsbedingung festgelegt ist, oder ein leerer String.