Class GradientCondition

Condiçãode gradiente

Acesse as condições de gradiente (cor) em ConditionalFormatRuleApis. Cada regra de formatação condicional pode conter uma única condição de gradiente. Uma condição de gradiente é definida por três pontos ao longo de uma escala numérica (mínimo, médio e máximo), cada um com uma cor, um valor e um InterpolationType. O conteúdo de uma célula é comparado aos valores na escala numérica, e a cor aplicada à célula é interpolada com base na proximidade do conteúdo da célula aos pontos mínimo, médio e máximo da condição de gradiente. 

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

Métodos

MétodoTipo de retornoBreve descrição
getMaxColorObject()ColorRecebe a cor definida para o valor máximo dessa condição de gradiente.
getMaxType()InterpolationTypeRecebe o tipo de interpolação para o valor máximo dessa condição de gradiente.
getMaxValue()StringRecebe o valor máximo dessa condição de gradiente.
getMidColorObject()ColorRecebe a cor definida para o valor do ponto médio dessa condição de gradiente.
getMidType()InterpolationTypeRecebe o tipo de interpolação para o valor do ponto médio dessa condição de gradiente.
getMidValue()StringRecebe o valor do ponto médio dessa condição de gradiente.
getMinColorObject()ColorRecebe a cor definida para o valor mínimo dessa condição de gradiente.
getMinType()InterpolationTypeRecebe o tipo de interpolação para o valor mínimo dessa condição de gradiente.
getMinValue()StringRecebe o valor mínimo dessa condição de gradiente.

Documentação detalhada

getMaxColorObject()

Recebe a cor definida para o valor máximo dessa condição de gradiente. Retorna null se a cor não tiver sido definida.

Retornar

Color: o conjunto de cores para o valor máximo dessa condição de gradiente ou null.

getMaxType()

Recebe o tipo de interpolação para o valor máximo dessa condição de gradiente. Retorna null se o tipo máximo de gradiente não tiver sido definido.

Retornar

InterpolationType: o tipo de interpolação para o valor máximo dessa condição de gradiente ou null.

getMaxValue()

Recebe o valor máximo dessa condição de gradiente. Retorna uma string vazia se InterpolationType for MAX ou se o valor máximo não tiver sido definido.

Retornar

String: o valor máximo, se especificado, ou uma string vazia.

getMidColorObject()

Recebe a cor definida para o valor do ponto médio dessa condição de gradiente. Retorna null se a cor não tiver sido definida.

Retornar

Color: o conjunto de cores para o valor do ponto médio dessa condição de gradiente ou null.

getMidType()

Recebe o tipo de interpolação para o valor do ponto médio dessa condição de gradiente. Retorna null se o tipo de ponto médio do gradiente não tiver sido definido.

Retornar

InterpolationType: o tipo de interpolação do valor do ponto médio dessa condição de gradiente ou null.

getMidValue()

Recebe o valor do ponto médio dessa condição de gradiente. Retorna uma string vazia se o valor intermediário do gradiente não tiver sido definido.

Retornar

String: o valor do ponto médio ou uma string vazia.

getMinColorObject()

Recebe a cor definida para o valor mínimo dessa condição de gradiente. Retorna null se a cor não tiver sido definida.

Retornar

Color: o conjunto de cores para o valor mínimo dessa condição de gradiente ou null.

getMinType()

Recebe o tipo de interpolação para o valor mínimo dessa condição de gradiente. Retorna null se o tipo de mínimo de gradiente não tiver sido definido.

Retornar

InterpolationType: o tipo de interpolação para o valor mínimo dessa condição de gradiente ou null.

getMinValue()

Recebe o valor mínimo dessa condição de gradiente. Retorna uma string vazia se InterpolationType for MIN ou se o valor mínimo não tiver sido definido.

Retornar

String: o valor mínimo, se especificado, ou uma string vazia.

Métodos obsoletos