AddCondFormatDataBar-Methode - HotXLS-Entwicklerreferenz

Fügt eine Excel 2007+ Datenbalken-Regel für bedingte Formatierung über einen Zellenbereich hinzu und gibt die neue TCondFormatRule zurück, damit die Stopp-Abstimmung der Regel vor dem Speichern angepasst werden kann. Erstellt intern einen CONDFMT12-Block und einen CF12-Datensatz beim BIFF8-Speichern; für XLSX-Ausgabe wird dieselbe Regel durch das OOXML-Element <cfRule type="dataBar"> gerendert. (Verfügbar seit v2.34.0.)

Syntax

function AddCondFormatDataBar(const ARange: WideString;
  AColor: LongWord;
  AMinKind: TXLSCfValueKind = cfvMinOfRange; const AMinValue: WideString = '';
  AMaxKind: TXLSCfValueKind = cfvMaxOfRange; const AMaxValue: WideString = ''): TCondFormatRule;

ARange	WideString. Sqref String, e.g. `'A1:A10'` oder `'B2:C20'`
AColor	LongWord. Füllfarbe der Datenleiste im Delphi-BGR-Format (R im niederwertigen Byte). Für eine blaue Füllung verwenden Sie `$00FF0000`; für Grün `$0000FF00`
AMinKind / AMaxKind	TXLSCfValueKind. Schwellentypen: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Die Standardzuordnung ist min→cfvMinOfRange und max→cfvMaxOfRange und entspricht damit den automatischen Standardgrenzen der Balken in Excel
AMinValue / AMaxValue	WideString. Threshold literal (numeric Text für cfvNumber/cfvPercent/cfvPercentile, A1-Bereich oder Formel Text für cfvFormula). Ignored für cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Beispiel

Dieses Beispiel fügt über A1:A10 einen blauen Datenbalken mit Standard-Min/Max-Bereichsgrenzen hinzu

Sheet.AddCondFormatDataBar('A1:A10', $00FF0000);

Siehe auch

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule-Klassen