Class GradientCondition
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Điều kiệnchuyển màu
Truy cập vào các điều kiện chuyển màu (màu sắc) trong ConditionalFormatRuleApis
.
Mỗi quy tắc định dạng có điều kiện có thể chứa một điều kiện chuyển màu. Điều kiện dải chuyển màu được xác định bằng 3 điểm dọc theo thang số (tối thiểu, trung bình và tối đa), mỗi điểm có một màu, một giá trị và một InterpolationType
. Nội dung của một ô được so sánh với các giá trị trong thang số và màu được áp dụng cho ô được nội suy dựa trên mức độ gần của nội dung ô với các điểm tối thiểu, trung bình và tối đa của điều kiện chuyển màu.
// 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}`);
}
Các phương thức ngừng hoạt động
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
getMaxColor()
| String | Lấy bộ màu được đặt cho giá trị tối đa của điều kiện chuyển màu này. |
getMidColor()
| String | Lấy bộ màu được đặt cho giá trị điểm trung bình của điều kiện độ dốc này. |
getMinColor()
| String | Lấy bộ màu được đặt cho giá trị tối thiểu của điều kiện độ dốc này. |
Tài liệu chi tiết
getMaxColorObject()
Lấy bộ màu được đặt cho giá trị tối đa của điều kiện chuyển màu này. Trả về null
nếu màu chưa được đặt.
Cầu thủ trả bóng
Color
– Màu được đặt cho giá trị tối đa của điều kiện độ dốc này hoặc null
.
getMaxType()
Lấy loại nội suy cho giá trị tối đa của điều kiện chuyển màu này. Trả về null
nếu bạn chưa đặt loại tối đa của chuyển màu.
Cầu thủ trả bóng
InterpolationType
– Loại nội suy cho giá trị tối đa của điều kiện chuyển màu này hoặc null
.
getMaxValue()
Lấy giá trị tối đa của điều kiện chuyển màu này. Trả về một chuỗi trống nếu InterpolationType
là MAX
hoặc nếu giá trị tối đa chưa được đặt.
Cầu thủ trả bóng
String
– Giá trị tối đa (nếu được chỉ định) hoặc một chuỗi trống.
getMidColorObject()
Lấy bộ màu được đặt cho giá trị điểm trung bình của điều kiện độ dốc này. Trả về null
nếu màu chưa được đặt.
Cầu thủ trả bóng
Color
– Màu được đặt cho giá trị điểm trung bình của điều kiện dải chuyển màu này hoặc null
.
getMidType()
Lấy loại nội suy cho giá trị trung điểm của điều kiện chuyển màu này. Trả về null
nếu bạn chưa đặt loại điểm giữa của chuyển màu.
Cầu thủ trả bóng
InterpolationType
– Loại nội suy cho giá trị trung điểm của điều kiện dải chuyển màu này hoặc null
.
getMidValue()
Lấy giá trị điểm giữa của điều kiện chuyển màu này. Trả về một chuỗi trống nếu giá trị giữa của dải chuyển màu chưa được đặt.
Cầu thủ trả bóng
String
– Giá trị trung điểm hoặc một chuỗi trống.
getMinColorObject()
Lấy bộ màu được đặt cho giá trị tối thiểu của điều kiện độ dốc này. Trả về null
nếu màu chưa được đặt.
Cầu thủ trả bóng
Color
– Tập hợp màu cho giá trị tối thiểu của điều kiện chuyển màu này hoặc null
.
getMinType()
Lấy loại nội suy cho giá trị tối thiểu của điều kiện chuyển màu này. Trả về null
nếu bạn chưa đặt loại tối thiểu của chuyển màu.
Cầu thủ trả bóng
InterpolationType
– Loại nội suy cho giá trị tối thiểu của điều kiện chuyển màu này hoặc null
.
getMinValue()
Lấy giá trị tối thiểu của điều kiện chuyển màu này. Trả về một chuỗi trống nếu InterpolationType
là MIN
hoặc nếu giá trị tối thiểu chưa được đặt.
Cầu thủ trả bóng
String
– Giá trị tối thiểu (nếu được chỉ định) hoặc một chuỗi trống.
Các phương thức ngừng hoạt động
getMaxColor()
Không dùng nữa. Được thay thế bằng getMaxColorObject()
Lấy bộ màu được đặt cho giá trị tối đa của điều kiện chuyển màu này. Trả về một chuỗi trống nếu màu chưa được đặt.
Cầu thủ trả bóng
String
– Tập hợp màu cho giá trị tối đa của điều kiện độ dốc này hoặc một chuỗi trống.
getMidColor()
Không dùng nữa. Được thay thế bằng getMidColorObject()
Lấy bộ màu được đặt cho giá trị điểm trung bình của điều kiện độ dốc này. Trả về một chuỗi trống nếu bạn chưa đặt màu.
Cầu thủ trả bóng
String
– Tập hợp màu cho giá trị điểm trung bình của điều kiện dải chuyển màu này hoặc một chuỗi trống.
getMinColor()
Không dùng nữa. Được thay thế bằng getMinColorObject()
Lấy bộ màu được đặt cho giá trị tối thiểu của điều kiện độ dốc này. Trả về một chuỗi trống nếu màu chưa được đặt.
Cầu thủ trả bóng
String
– Tập hợp màu cho giá trị tối thiểu của điều kiện chuyển màu này hoặc một chuỗi trống.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-05 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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."]]