دسترسی به شرایط گرادیان (رنگ) در Conditional Format Rule Apis . هر قانون قالب شرطی ممکن است شامل یک شرط گرادیان واحد باشد. یک شرط گرادیان توسط سه نقطه در امتداد یک مقیاس عددی (حداقل، متوسط و حداکثر) تعریف میشود که هر کدام دارای یک رنگ، یک مقدار و یک Interpolation Type هستند. محتوای یک سلول با مقادیر در مقیاس عددی مقایسه میشود و رنگ اعمال شده به سلول بر اساس نزدیکی محتوای سلول به شرایط گرادیان، نقاط حداقل، متوسط و حداکثر، درونیابی میشود.
// 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}`); }
روشها
| روش | نوع بازگشتی | شرح مختصر |
|---|---|---|
get Max Color Object() | Color |null | رنگ تنظیم شده برای حداکثر مقدار این شرط گرادیان را برمیگرداند. |
get Max Type() | Interpolation Type |null | نوع درونیابی را برای حداکثر مقدار این شرط گرادیان دریافت میکند. |
get Max Value() | String | حداکثر مقدار این شرط گرادیان را دریافت میکند. |
get Mid Color Object() | Color |null | رنگ تنظیم شده برای مقدار نقطه میانی این شرط گرادیان را دریافت میکند. |
get Mid Type() | Interpolation Type |null | نوع درونیابی را برای مقدار نقطه میانی این شرط گرادیان دریافت میکند. |
get Mid Value() | String | مقدار نقطه میانی این شرط گرادیان را دریافت میکند. |
get Min Color Object() | Color |null | رنگ تنظیم شده برای حداقل مقدار این شرط گرادیان را برمیگرداند. |
get Min Type() | Interpolation Type |null | نوع درونیابی را برای حداقل مقدار این شرط گرادیان دریافت میکند. |
get Min Value() | String | حداقل مقدار این شرط گرادیان را دریافت میکند. |
مستندات دقیق
get Max Color Object()
رنگ تنظیم شده برای حداکثر مقدار این شرط گرادیان را برمیگرداند. اگر رنگ تنظیم نشده باشد، null را برمیگرداند.
بازگشت
Color |null — رنگی که برای حداکثر مقدار این شرط گرادیان یا null تنظیم شده است.
get Max Type()
نوع درونیابی را برای حداکثر مقدار این شرط گرادیان دریافت میکند. اگر نوع گرادیان حداکثر تنظیم نشده باشد، null را برمیگرداند.
بازگشت
Interpolation Type |null — نوع درونیابی برای حداکثر مقدار این شرط گرادیان یا null .
get Max Value()
حداکثر مقدار این شرط گرادیان را دریافت میکند. اگر Interpolation Type MAX باشد یا اگر حداکثر مقدار تنظیم نشده باشد، یک رشته خالی برمیگرداند.
بازگشت
String - حداکثر مقدار در صورت مشخص شدن یا یک رشته خالی.
get Mid Color Object()
رنگ تنظیم شده برای مقدار نقطه میانی این شرط گرادیان را برمیگرداند. اگر رنگ تنظیم نشده باشد، null را برمیگرداند.
بازگشت
Color |null — رنگی که برای مقدار نقطه میانی این شرط گرادیان یا null تنظیم شده است.
get Mid Type()
نوع درونیابی را برای مقدار نقطه میانی این شرط گرادیان دریافت میکند. اگر نوع میانه گرادیان تنظیم نشده باشد، مقدار null را برمیگرداند.
بازگشت
Interpolation Type |null — نوع درونیابی برای مقدار نقطه میانی این شرط گرادیان یا null .
get Mid Value()
مقدار نقطه میانی این شرط گرادیان را دریافت میکند. اگر مقدار میانی گرادیان تنظیم نشده باشد، یک رشته خالی برمیگرداند.
بازگشت
String - مقدار نقطه میانی یا یک رشته خالی.
get Min Color Object()
رنگ تنظیم شده برای حداقل مقدار این شرط گرادیان را برمیگرداند. اگر رنگ تنظیم نشده باشد، null را برمیگرداند.
بازگشت
Color |null — رنگی که برای حداقل مقدار این شرط گرادیان یا null تنظیم شده است.
get Min Type()
نوع درونیابی را برای حداقل مقدار این شرط گرادیان دریافت میکند. اگر نوع گرادیان min تنظیم نشده باشد، null را برمیگرداند.
بازگشت
Interpolation Type |null — نوع درونیابی برای حداقل مقدار این شرط گرادیان یا null .
get Min Value()
حداقل مقدار این شرط گرادیان را دریافت میکند. اگر Interpolation Type MIN باشد یا مقدار حداقل تنظیم نشده باشد، یک رشته خالی برمیگرداند.
بازگشت
String - حداقل مقدار در صورت مشخص شدن یا یک رشته خالی.