Class GradientCondition

Bedingung

Greifen Sie in ConditionalFormatRuleApis auf Farbverlauf-Bedingungen zu. Jede Regel für die bedingte Formatierung kann eine einzelne Bedingung für den Farbverlauf enthalten. Eine Bedingung für einen Farbverlauf wird durch drei Punkte auf einer Zahlenskala (Minimum, Mittelwert und Maximum) 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 Mindest-, Mittel- und Höchstpunkten 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()Color|nullRuft die Farbe ab, die für den Höchstwert dieser Gradientenbedingung festgelegt ist.
getMaxType()InterpolationType|nullRuft den Interpolationstyp für den Maximalwert dieser Gradientenbedingung ab.
getMaxValue()StringRuft den Höchstwert dieser Gradientenbedingung ab.
getMidColorObject()Color|nullRuft die für den Mittelwert dieser Gradientenbedingung festgelegte Farbe ab.
getMidType()InterpolationType|nullRuft den Interpolationstyp für den Mittelpunktwert dieser Gradientenbedingung ab.
getMidValue()StringRuft den Mittelpunktwert dieser Gradientenbedingung ab.
getMinColorObject()Color|nullRuft die Farbe ab, die für den Mindestwert dieser Farbverlauf-Bedingung festgelegt ist.
getMinType()InterpolationType|nullRuft den Interpolationstyp für den Mindestwert dieser Gradientenbedingung ab.
getMinValue()StringGibt den Mindestwert dieser Gradientenbedingung zurück.

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|null: Die für den Höchstwert dieser Gradientenbedingung festgelegte Farbe oder null.

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|null: Der Interpolationstyp für den Maximalwert dieser Gradientenbedingung oder null.

getMaxValue()

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

Rückflug

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

getMidColorObject()

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

Rückflug

Color|null: 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|null: 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 mittlere Wert 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 Farbverlauf-Bedingung festgelegt ist. Gibt null zurück, wenn die Farbe nicht festgelegt wurde.

Rückflug

Color|null: 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 Mindestwerttyp für den Farbverlauf nicht festgelegt wurde.

Rückflug

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

getMinValue()

Gibt den Mindestwert dieser Gradientenbedingung zurück. 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