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