Class GradientCondition

Градиентное условие

Доступ к условиям градиента (цвета) в Conditional Format Rule Apis . Каждое правило условного форматирования может содержать одно условие градиента. Условие градиента определяется тремя точками вдоль числовой шкалы (мин., мид. и макс.), каждая из которых имеет цвет, значение и Interpolation Type . Содержимое ячейки сравнивается со значениями в числовой шкале, и цвет, применяемый к ячейке, интерполируется на основе близости содержимого ячейки к точкам мин., мид. и макс. условия градиента.

// 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}`);
}

Методы

Метод Тип возвращаемого значения Краткое описание
get Max Color Object() Color |null Получает цвет, заданный для максимального значения данного градиентного условия.
get Max Type() Interpolation Type |null Получает тип интерполяции для максимального значения данного условия градиента.
get Max Value() String Получает максимальное значение этого градиентного условия.
get Mid Color Object() Color |null Получает цвет, заданный для средней точки этого градиентного условия.
get Mid Type() Interpolation Type |null Получает тип интерполяции для значения средней точки данного градиентного условия.
get Mid Value() String Получает значение середины этого градиентного условия.
get Min Color Object() Color |null Получает цвет, соответствующий минимальному значению данного градиентного условия.
get Min Type() Interpolation Type |null Получает тип интерполяции для минимального значения данного условия градиента.
get Min Value() String Получает минимальное значение этого градиентного условия.

Подробная документация

get Max Color Object()

Получает цвет, заданный для максимального значения этого градиентного условия. Возвращает null если цвет не был задан.

Возвращаться

Color |null — Цвет, заданный для максимального значения этого градиентного условия, или null .


get Max Type()

Получает тип интерполяции для максимального значения этого условия градиента. Возвращает null если тип максимального значения градиента не задан.

Возвращаться

Interpolation Type |null — Тип интерполяции для максимального значения этого условия градиента или null .


get Max Value()

Получает максимальное значение этого градиентного условия. Возвращает пустую строку, если Interpolation Type равен MAX или если максимальное значение не задано.

Возвращаться

String — максимальное значение, если оно указано, или пустая строка.


get Mid Color Object()

Получает цвет, заданный для средней точки этого градиентного условия. Возвращает null если цвет не был задан.

Возвращаться

Color |null — Цвет, заданный для среднего значения этого градиентного условия, или null .


get Mid Type()

Получает тип интерполяции для значения середины градиентного условия. Возвращает null если тип середины градиента не задан.

Возвращаться

Interpolation Type |null — Тип интерполяции для значения средней точки этого градиентного условия или null .


get Mid Value()

Получает среднее значение условия градиента. Возвращает пустую строку, если среднее значение градиента не задано.

Возвращаться

String — значение середины строки или пустая строка.


get Min Color Object()

Получает цвет, заданный для минимального значения этого градиентного условия. Возвращает null если цвет не был задан.

Возвращаться

Color |null — Цвет, заданный для минимального значения этого градиентного условия, или null .


get Min Type()

Получает тип интерполяции для минимального значения этого условия градиента. Возвращает null если тип минимального значения градиента не задан.

Возвращаться

Interpolation Type |null — Тип интерполяции для минимального значения этого условия градиента или null .


get Min Value()

Получает минимальное значение этого градиентного условия. Возвращает пустую строку, если Interpolation TypeMIN , или если минимальное значение не задано.

Возвращаться

String — минимальное значение, если оно указано, или пустая строка.

Устаревшие методы