HotXLS-Dokumentation

AddCondFormatColorScale3-Methode

Fügt eine Excel 2007+ 3-Stop-Farbskala-Regel für bedingte Formatierung über einen Zellenbereich hinzu und gibt die neue TCondFormatRule zurück. Zellen erhalten eine Verlaufsfüllung, die zwischen drei Farbstopps interpoliert: Minimum, Mitte (Standard beim 50. Perzentil) und Maximum. (Verfügbar seit v2.34.0.)

Syntax

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 Farben in Delphi BGR Format
AMinKind / AMidKind / AMaxKind TXLSCfValueKind. Threshold types. Mid defaults zu cfvPercentile / '50' — klassisch "Red–Yellow–Green" Excel preset
AMinValue / AMidValue / AMaxValue WideString. Threshold literal Text. AMidValue defaults zu '50' zu pair mit cfvPercentile

Beispiel

Dieses Beispiel färbt A1:A10 mit der klassischen Rot-Gelb-Grün-Skala

Sheet.AddCondFormatColorScale3('A1:A10',
  $000000FF, $0000FFFF, $0000FF00);

Siehe auch