Class GradientCondition
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
그라데이션조건
ConditionalFormatRuleApis
에서 그라데이션 (색상) 조건에 액세스합니다.
각 조건부 서식 규칙에는 하나의 그라데이션 조건이 포함될 수 있습니다. 그라데이션 조건은 숫자 스케일 (최소, 중간, 최대)을 따라 세 점으로 정의되며 각 점에는 색상, 값, InterpolationType
이 있습니다. 셀의 콘텐츠가 숫자 스케일의 값과 비교되고 셀에 적용된 색상은 그라데이션 조건의 최소, 중간, 최대 지점과의 셀 콘텐츠 근접성을 기반으로 보간됩니다.
// 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}`);
}
자세한 문서
getMaxColorObject()
이 그라데이션 조건의 최댓값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 null
을 반환합니다.
리턴
Color
- 이 그라데이션 조건의 최댓값에 설정된 색상 또는 null
입니다.
getMaxType()
이 그라데이션 조건의 최댓값에 대한 보간 유형을 가져옵니다. 그라데이션 최대 유형이 설정되지 않은 경우 null
을 반환합니다.
리턴
InterpolationType
: 이 그라데이션 조건의 최댓값 또는 null
의 보간 유형입니다.
getMaxValue()
이 그라데이션 조건의 최댓값을 가져옵니다. InterpolationType
이 MAX
이거나 최대 값이 설정되지 않은 경우 빈 문자열을 반환합니다.
리턴
String
- 지정된 경우 최댓값 또는 빈 문자열입니다.
getMidColorObject()
이 그라데이션 조건의 중간값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 null
을 반환합니다.
리턴
Color
- 이 그라데이션 조건의 중간값에 설정된 색상 또는 null
입니다.
getMidType()
이 그라데이션 조건의 중간점 값에 대한 보간 유형을 가져옵니다. 그라데이션 중간 유형이 설정되지 않은 경우 null
을 반환합니다.
리턴
InterpolationType
: 이 그라데이션 조건의 중간점 값 또는 null
의 보간 유형입니다.
getMidValue()
이 그라데이션 조건의 중간 값을 가져옵니다. 그라데이션 중간 값이 설정되지 않은 경우 빈 문자열을 반환합니다.
리턴
String
- 중간점 값 또는 빈 문자열입니다.
getMinColorObject()
이 그라데이션 조건의 최솟값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 null
을 반환합니다.
리턴
Color
- 이 그라데이션 조건의 최솟값 또는 null
에 설정된 색상입니다.
getMinType()
이 그라데이션 조건의 최솟값에 대한 보간 유형을 가져옵니다. 그라데이션 최소 유형이 설정되지 않은 경우 null
을 반환합니다.
리턴
InterpolationType
: 이 그라데이션 조건 또는 null
의 최솟값에 대한 보간 유형입니다.
getMinValue()
이 그라데이션 조건의 최솟값을 가져옵니다. InterpolationType
이 MIN
이거나 최소 값이 설정되지 않은 경우 빈 문자열을 반환합니다.
리턴
String
- 지정된 경우 최솟값 또는 빈 문자열입니다.
지원 중단된 메서드
getMaxColor()
지원 중단되었습니다. getMaxColorObject()
로 대체됨
이 그라데이션 조건의 최댓값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 빈 문자열을 반환합니다.
리턴
String
- 이 그라데이션 조건의 최댓값에 설정된 색상 또는 빈 문자열입니다.
getMidColor()
지원 중단되었습니다. getMidColorObject()
로 대체됨
이 그라데이션 조건의 중간값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 빈 문자열을 반환합니다.
리턴
String
- 이 그라데이션 조건의 중간값에 설정된 색상 또는 빈 문자열입니다.
getMinColor()
지원 중단되었습니다. getMinColorObject()
로 대체됨
이 그라데이션 조건의 최솟값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 빈 문자열을 반환합니다.
리턴
String
- 이 그라데이션 조건의 최솟값에 설정된 색상 또는 빈 문자열입니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-05(UTC)
[null,null,["최종 업데이트: 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."]]