Adds an Excel 2007+ 3-stop
Color Scale conditional formatting rule over a cell range, returning the new
TCondFormatRule. Cells receive a gradient fill interpolating between three color stops: min, mid (default at the 50th percentile), and max. (Available since v2.34.0.)
function AddCondFormatColorScale3(
const ARange: WideString;
AMinColor, AMidColor, AMaxColor: LongWord;
AMinKind:
TXLSCfValueKind = cfvMinOfRange;
const AMinValue: WideString = '';
AMidKind:
TXLSCfValueKind = cfvPercentile;
const AMidValue: WideString = '50';
AMaxKind:
TXLSCfValueKind = cfvMaxOfRange;
const AMaxValue: WideString = ''):
TCondFormatRule;
| ARange |
WideString. Sqref string, e.g. 'A1:A10'. |
| AMinColor / AMidColor / AMaxColor |
LongWord. Three gradient anchor colors in Delphi BGR format. |
| AMinKind / AMidKind / AMaxKind |
TXLSCfValueKind. Threshold types. Mid defaults to cfvPercentile / '50' — the classic "Red–Yellow–Green" Excel preset. |
| AMinValue / AMidValue / AMaxValue |
WideString. Threshold literal text. AMidValue defaults to '50' to pair with cfvPercentile. |