Class GradientCondition

Градиентное состояние

Доступ к условиям градиента (цвета) в Conditional Format Rule Apis . Каждое правило условного форматирования может содержать одно условие градиента. Условие градиента определяется тремя точками на числовой шкале (min, mid и max), каждая из которых имеет цвет, значение и 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 — минимальное значение, если указано, или пустая строка.

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