AddCondFormatColorScale2 method

Adds an Excel 2007+ 2-stop Colour Scale conditional formatting rule over a cell range, returning the new TCondFormatRule so the rule's DXF Style override can be refined before save. Cells receive a gradient fill that interpolates between AMinColor (at the min threshold) and AMaxColor (at the max threshold). (Available since v2.34.0.)

Syntax

function AddCondFormatColorScale2(const ARange: WideString;
  AMinColor, AMaxColor: LongWord;
  AMinKind: TXLSCfValueKind = cfvMinOfRange; const AMinValue: WideString = '';
  AMaxKind: TXLSCfValueKind = cfvMaxOfRange; const AMaxValue: WideString = ''): TCondFormatRule;

ARange	WideString. Sqref string, e.g. `'A1:A10'`.
AMinColor / AMaxColor	LongWord. Gradient endpoint colours in Delphi BGR format (R in the low byte).
AMinKind / AMaxKind	TXLSCfValueKind. Threshold types — see TXLSCfValueKind.
AMinValue / AMaxValue	WideString. Threshold literal; ignored for kinds that auto-detect.

Example

This example colours A1:A10 from white to green based on the range's min and max values.

Sheet.AddCondFormatColorScale2('A1:A10', $00FFFFFF, $0000FF00);

Syntax

Example

See also