Class GradientCondition

Conditionde dégradé

Accédez aux conditions de dégradé (couleur) dans ConditionalFormatRuleApis. Chaque règle de mise en forme conditionnelle ne peut contenir qu'une seule condition de dégradé. Une condition de dégradé est définie par trois points sur une échelle numérique (min, mid et max), chacun ayant une couleur, une valeur et un InterpolationType. Le contenu d'une cellule est comparé aux valeurs de l'échelle numérique, et la couleur appliquée à la cellule est interpolée en fonction de la proximité du contenu de la cellule par rapport aux points min, mid et max de la condition de dégradé.

// 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éthodes

Méthode	Type renvoyé	Brève description
getMaxColorObject()	Color	Obtient la couleur définie pour la valeur maximale de cette condition de dégradé.
getMaxType()	InterpolationType	Obtient le type d'interpolation pour la valeur maximale de cette condition de dégradé.
getMaxValue()	String	Obtient la valeur maximale de cette condition de dégradé.
getMidColorObject()	Color	Récupère la couleur définie pour la valeur du point médian de cette condition de dégradé.
getMidType()	InterpolationType	Obtient le type d'interpolation pour la valeur médiane de cette condition de dégradé.
getMidValue()	String	Récupère la valeur du point médian de cette condition de dégradé.
getMinColorObject()	Color	Récupère la couleur définie pour la valeur minimale de cette condition de dégradé.
getMinType()	InterpolationType	Obtient le type d'interpolation pour la valeur minimale de cette condition de dégradé.
getMinValue()	String	Obtient la valeur minimale de cette condition de dégradé.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
getMaxColor()	String	Obtient la couleur définie pour la valeur maximale de cette condition de dégradé.
getMidColor()	String	Récupère la couleur définie pour la valeur du point médian de cette condition de dégradé.
getMinColor()	String	Récupère la couleur définie pour la valeur minimale de cette condition de dégradé.

Documentation détaillée

getMaxColorObject()

Obtient la couleur définie pour la valeur maximale de cette condition de dégradé. Renvoie null si la couleur n'a pas été définie.

Renvois

Color : ensemble de couleurs défini pour la valeur maximale de cette condition de dégradé ou null.

---

getMaxType()

Obtient le type d'interpolation pour la valeur maximale de cette condition de dégradé. Renvoie null si le type de gradient max n'a pas été défini.

Renvois

InterpolationType : type d'interpolation pour la valeur maximale de cette condition de dégradé ou null.

---

getMaxValue()

Obtient la valeur maximale de cette condition de dégradé. Renvoie une chaîne vide si InterpolationType est MAX ou si la valeur maximale n'a pas été définie.

Renvois

String : valeur maximale si elle est spécifiée, ou chaîne vide.

---

getMidColorObject()

Récupère la couleur définie pour la valeur du point médian de cette condition de dégradé. Renvoie null si la couleur n'a pas été définie.

Renvois

Color : ensemble de couleurs défini pour la valeur du point médian de cette condition de dégradé ou null.

---

getMidType()

Obtient le type d'interpolation pour la valeur médiane de cette condition de dégradé. Renvoie null si le type de point médian du dégradé n'a pas été défini.

Renvois

InterpolationType : type d'interpolation pour la valeur médiane de cette condition de dégradé ou null.

---

getMidValue()

Récupère la valeur du point médian de cette condition de dégradé. Renvoie une chaîne vide si la valeur médiane du dégradé n'a pas été définie.

Renvois

String : valeur médiane ou chaîne vide.

---

getMinColorObject()

Récupère la couleur définie pour la valeur minimale de cette condition de dégradé. Renvoie null si la couleur n'a pas été définie.

Renvois

Color : ensemble de couleurs défini pour la valeur minimale de cette condition de dégradé ou null.

---

getMinType()

Obtient le type d'interpolation pour la valeur minimale de cette condition de dégradé. Renvoie null si le type de min de dégradé n'a pas été défini.

Renvois

InterpolationType : type d'interpolation pour la valeur minimale de cette condition de dégradé ou null.

---

getMinValue()

Obtient la valeur minimale de cette condition de dégradé. Renvoie une chaîne vide si InterpolationType est MIN ou si la valeur minimale n'a pas été définie.

Renvois

String : valeur minimale si elle est spécifiée, ou chaîne vide.

Méthodes obsolètes

getMaxColor()

Obsolète. Remplacé par getMaxColorObject()

Obtient la couleur définie pour la valeur maximale de cette condition de dégradé. Renvoie une chaîne vide si la couleur n'a pas été définie.

Renvois

String : couleur définie pour la valeur maximale de cette condition de dégradé ou chaîne vide.

---

getMidColor()

Obsolète. Remplacé par getMidColorObject()

Récupère la couleur définie pour la valeur du point médian de cette condition de dégradé. Renvoie une chaîne vide si la couleur n'a pas été définie.

Renvois

String : ensemble de couleurs défini pour la valeur du point médian de cette condition de dégradé ou chaîne vide.

---

getMinColor()

Obsolète. Remplacé par getMinColorObject()

Récupère la couleur définie pour la valeur minimale de cette condition de dégradé. Renvoie une chaîne vide si la couleur n'a pas été définie.

Renvois

String : ensemble de couleurs défini pour la valeur minimale de cette condition de dégradé ou chaîne vide.