Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
GradientWarunek
Dostęp do warunków gradientu (koloru) w domenie ConditionalFormatRuleApis.
Każda reguła formatowania warunkowego może zawierać jeden warunek gradientu. Warunek gradientu jest określany przez 3 punkty na skali liczbowej (minimalny, środkowy i maksymalny), z których każdy ma kolor, wartość i InterpolationType. Zawartość komórki jest porównywana z wartościami na skali liczbowej, a kolor stosowany do komórki jest interpolowany na podstawie tego, jak blisko zawartość komórki znajduje się punktów min, mid i max warunku gradientu.
// Logs all the information inside gradient conditional format rules on a sheet.// The below snippet assumes all colors have ColorType.RGB.constsheet=SpreadsheetApp.getActiveSheet();construles=sheet.getConditionalFormatRules();for(leti=0;i < rules.length;i++){constgradient=rules[i].getGradientCondition();constminColor=gradient.getMinColorObject().asRgbColor().asHexString();constminType=gradient.getMinType();constminValue=gradient.getMinValue();constmidColor=gradient.getMidColorObject().asRgbColor().asHexString();constmidType=gradient.getMidType();constmidValue=gradient.getMidValue();constmaxColor=gradient.getMaxColorObject().asRgbColor().asHexString();constmaxType=gradient.getMaxType();constmaxValue=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}`);}
Pobiera kolor ustawiony dla minimalnej wartości tego warunku gradientu.
Szczegółowa dokumentacja
getMaxColorObject()
Pobiera kolor ustawiony dla maksymalnej wartości tego warunku gradientu. Zwraca null, jeśli kolor nie został ustawiony.
Powrót
Color – kolor ustawiony dla maksymalnej wartości tego warunku gradientu lub null.
getMaxType()
Pobiera typ interpolacji dla maksymalnej wartości tego warunku gradientu. Zwraca wartość null, jeśli nie ustawiono maksymalnego typu gradientu.
Powrót
InterpolationType – typ interpolacji dla maksymalnej wartości tego warunku gradientu lub null.
getMaxValue()
Pobiera maksymalną wartość tego warunku gradientu. Zwraca pusty ciąg znaków, jeśli InterpolationType to MAX lub jeśli nie ustawiono wartości maksymalnej.
Powrót
String – maksymalna wartość, jeśli została określona, lub pusty ciąg znaków.
getMidColorObject()
Pobiera kolor ustawiony dla wartości środkowej tego warunku gradientu. Zwraca null, jeśli kolor nie został ustawiony.
Powrót
Color – kolor ustawiony dla wartości środkowej tego warunku gradientu lub null.
getMidType()
Pobiera typ interpolacji dla wartości środkowej tego warunku gradientu. Zwraca null, jeśli typ środka gradientu nie został ustawiony.
Powrót
InterpolationType – typ interpolacji dla wartości środkowej tego warunku gradientu lub null.
getMidValue()
Pobiera wartość punktu środkowego tego warunku gradientu. Zwraca pusty ciąg znaków, jeśli wartość środkowa gradientu nie została ustawiona.
Powrót
String – wartość środkowa lub pusty ciąg znaków.
getMinColorObject()
Pobiera kolor ustawiony dla minimalnej wartości tego warunku gradientu. Zwraca null, jeśli kolor nie został ustawiony.
Powrót
Color – kolor ustawiony dla minimalnej wartości tego warunku gradientu lub null.
getMinType()
Pobiera typ interpolacji dla minimalnej wartości tego warunku gradientu. Zwraca wartość null, jeśli minimalny typ gradientu nie został ustawiony.
Powrót
InterpolationType – typ interpolacji dla minimalnej wartości tego warunku gradientu lub null.
getMinValue()
Pobiera minimalną wartość tego warunku gradientu. Zwraca pusty ciąg znaków, jeśli InterpolationType to MIN lub jeśli nie ustawiono wartości minimalnej.
Powrót
String – minimalna wartość, jeśli została określona, lub pusty ciąg znaków.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-08-05 UTC."],[[["\u003cp\u003eGradient conditions in Google Sheets allow you to apply color scales to cells based on their values, interpolating colors between minimum, midpoint, and maximum points.\u003c/p\u003e\n"],["\u003cp\u003eEach gradient condition is defined by three points (min, mid, max), each having a color, value, and interpolation type.\u003c/p\u003e\n"],["\u003cp\u003eYou can access and manipulate gradient conditions programmatically using Apps Script methods like \u003ccode\u003egetMinColorObject()\u003c/code\u003e, \u003ccode\u003egetMidValue()\u003c/code\u003e, and \u003ccode\u003egetMaxType()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDeprecated methods like \u003ccode\u003egetMinColor()\u003c/code\u003e, \u003ccode\u003egetMidColor()\u003c/code\u003e, and \u003ccode\u003egetMaxColor()\u003c/code\u003e have been replaced by object-based alternatives for color retrieval.\u003c/p\u003e\n"]]],["Gradient conditions, within conditional format rules, define cell colors based on a number scale with minimum, midpoint, and maximum values. Each point has a color, value, and interpolation type. Methods like `getMinColorObject()`, `getMidType()`, and `getMaxValue()` retrieve these attributes. Cell content is compared to these values to interpolate and apply a corresponding color. Deprecated methods (`getMinColor()`, `getMidColor()`, `getMaxColor()`) are replaced with `get[Point]ColorObject()`.\n"],null,["# Class GradientCondition\n\nGradientCondition\n\nAccess gradient (color) conditions in [ConditionalFormatRuleApis](/apps-script/reference/spreadsheet/conditional-format-rule).\nEach conditional format rule may contain a single gradient condition. A gradient condition is\ndefined by three points along a number scale (min, mid, and max), each of which has a color, a\nvalue, and a [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type). The content of a cell is\ncompared to the values in the number scale and the color applied to the cell is interpolated\nbased on the cell content's proximity to the gradient condition min, mid, and max points.\n\n```javascript\n// Logs all the information inside gradient conditional format rules on a sheet.\n// The below snippet assumes all colors have ColorType.RGB.\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst rules = sheet.getConditionalFormatRules();\nfor (let i = 0; i \u003c rules.length; i++) {\n const gradient = rules[i].getGradientCondition();\n\n const minColor = gradient.getMinColorObject().asRgbColor().asHexString();\n const minType = gradient.getMinType();\n const minValue = gradient.getMinValue();\n const midColor = gradient.getMidColorObject().asRgbColor().asHexString();\n const midType = gradient.getMidType();\n const midValue = gradient.getMidValue();\n const maxColor = gradient.getMaxColorObject().asRgbColor().asHexString();\n const maxType = gradient.getMaxType();\n const maxValue = gradient.getMaxValue();\n\n Logger.log(`The conditional format gradient information for rule ${i}:\n MinColor ${minColor}, MinType ${minType}, MinValue ${minValue},\n MidColor ${midColor}, MidType ${midType}, MidValue ${midValue},\n MaxColor ${maxColor}, MaxType ${maxType}, MaxValue ${maxValue}`);\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------|----------------------------------------------------------------------------|--------------------------------------------------------------------------------|\n| [getMaxColorObject()](#getMaxColorObject()) | [Color](/apps-script/reference/spreadsheet/color) | Gets the color set for the maximum value of this gradient condition. |\n| [getMaxType()](#getMaxType()) | [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) | Gets the interpolation type for the maximum value of this gradient condition. |\n| [getMaxValue()](#getMaxValue()) | `String` | Gets the max value of this gradient condition. |\n| [getMidColorObject()](#getMidColorObject()) | [Color](/apps-script/reference/spreadsheet/color) | Gets the color set for the midpoint value of this gradient condition. |\n| [getMidType()](#getMidType()) | [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) | Gets the interpolation type for the midpoint value of this gradient condition. |\n| [getMidValue()](#getMidValue()) | `String` | Gets the midpoint value of this gradient condition. |\n| [getMinColorObject()](#getMinColorObject()) | [Color](/apps-script/reference/spreadsheet/color) | Gets the color set for the minimum value of this gradient condition. |\n| [getMinType()](#getMinType()) | [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) | Gets the interpolation type for the minimum value of this gradient condition. |\n| [getMinValue()](#getMinValue()) | `String` | Gets the minimum value of this gradient condition. |\n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|---------------------------------|-------------|-----------------------------------------------------------------------|\n| [getMaxColor()](#getMaxColor()) | `String` | Gets the color set for the maximum value of this gradient condition. |\n| [getMidColor()](#getMidColor()) | `String` | Gets the color set for the midpoint value of this gradient condition. |\n| [getMinColor()](#getMinColor()) | `String` | Gets the color set for the minimum value of this gradient condition. |\n\nDetailed documentation\n----------------------\n\n### `get``Max``Color``Object()`\n\nGets the color set for the maximum value of this gradient condition. Returns `null` if\nthe color hasn't been set.\n\n#### Return\n\n\n[Color](/apps-script/reference/spreadsheet/color) --- The color set for the maximum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Max``Type()`\n\nGets the interpolation type for the maximum value of this gradient condition. Returns `null` if the gradient max type hasn't been set.\n\n#### Return\n\n\n[InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) --- The interpolation type for the maximum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Max``Value()`\n\nGets the max value of this gradient condition. Returns an empty string if the [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) is `MAX` or if the max value hasn't been\nset.\n\n#### Return\n\n\n`String` --- The maximum value if specified or an empty string.\n\n*** ** * ** ***\n\n### `get``Mid``Color``Object()`\n\nGets the color set for the midpoint value of this gradient condition. Returns `null` if\nthe color hasn't been set.\n\n#### Return\n\n\n[Color](/apps-script/reference/spreadsheet/color) --- The color set for the midpoint value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Mid``Type()`\n\nGets the interpolation type for the midpoint value of this gradient condition. Returns `null` if the gradient mid type hasn't been set.\n\n#### Return\n\n\n[InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) --- The interpolation type for the midpoint value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Mid``Value()`\n\nGets the midpoint value of this gradient condition. Returns an empty string if the gradient mid\nvalue hasn't been set.\n\n#### Return\n\n\n`String` --- The midpoint value or an empty string.\n\n*** ** * ** ***\n\n### `get``Min``Color``Object()`\n\nGets the color set for the minimum value of this gradient condition. Returns `null` if\nthe color hasn't been set.\n\n#### Return\n\n\n[Color](/apps-script/reference/spreadsheet/color) --- The color set for the minimum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Min``Type()`\n\nGets the interpolation type for the minimum value of this gradient condition. Returns `null` if the gradient min type hasn't been set.\n\n#### Return\n\n\n[InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) --- The interpolation type for the minimum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Min``Value()`\n\nGets the minimum value of this gradient condition. Returns an empty string if the [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) is `MIN` or if the min value hasn't been\nset.\n\n#### Return\n\n\n`String` --- The minimum value if specified or an empty string.\n\nDeprecated methods\n------------------\n\n### `get``Max``Color()`\n\n\n**Deprecated.** Replaced by [getMaxColorObject()](#getMaxColorObject())\n\nGets the color set for the maximum value of this gradient condition. Returns an empty string if\nthe color hasn't been set.\n\n#### Return\n\n\n`String` --- The color set for the maximum value of this gradient condition or an empty string.\n\n*** ** * ** ***\n\n### `get``Mid``Color()`\n\n\n**Deprecated.** Replaced by [getMidColorObject()](#getMidColorObject())\n\nGets the color set for the midpoint value of this gradient condition. Returns an empty string\nif the color hasn't been set.\n\n#### Return\n\n\n`String` --- The color set for the midpoint value of this gradient condition or an empty string.\n\n*** ** * ** ***\n\n### `get``Min``Color()`\n\n\n**Deprecated.** Replaced by [getMinColorObject()](#getMinColorObject())\n\nGets the color set for the minimum value of this gradient condition. Returns an empty string if\nthe color hasn't been set.\n\n#### Return\n\n\n`String` --- The color set for the minimum value of this gradient condition or an empty string."]]