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 Получает набор цветов для максимального значения этого условия градиента.
get Max Type() Interpolation Type Получает тип интерполяции для максимального значения этого условия градиента.
get Max Value() String Получает максимальное значение этого условия градиента.
get Mid Color Object() Color Получает набор цветов для значения средней точки этого условия градиента.
get Mid Type() Interpolation Type Получает тип интерполяции для значения средней точки этого условия градиента.
get Mid Value() String Получает значение средней точки этого условия градиента.
get Min Color Object() Color Получает набор цветов для минимального значения этого условия градиента.
get Min Type() Interpolation Type Получает тип интерполяции для минимального значения этого условия градиента.
get Min Value() String Получает минимальное значение этого условия градиента.

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

get Max Color Object()

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

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

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

get Max Type()

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

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

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

get Max Value()

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

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

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

get Mid Color Object()

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

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

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

get Mid Type()

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

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

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

get Mid Value()

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

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

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

get Min Color Object()

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

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

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

get Min Type()

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

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

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

get Min Value()

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

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

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

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