Metoden AddCondFormatDataBar - HotXLS utvecklarreferens

Lägger till en Excel 2007+ Datafält-villkorsformateringsregel över ett cellintervall och returnerar den nya TCondFormatRule så att regelns per-stopp-inställningar kan förfinas före spara. Skapar internt ett CONDFMT12-block och en CF12-post vid BIFF8-spara; för XLSX-utdata renderas samma regel via OOXML <cfRule type="dataBar">-elementet. (Tillgänglig sedan 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'` eller `'B2:C20'`
AColor	Barens fyllningsfärg i Delphi BGR-format (R i den minst signifikanta bytepositionen). För en blå fyllning använd $00FF0000; för grön $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Tröskeltyper: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Standardvärden mappar min→cfvMinOfRange och max→cfvMaxOfRange, vilket matchar Excels standardgränser för automatiska staplar
AMinValue / AMaxValue	WideString. Threshold literal (numeric text för cfvNumber/cfvPercent/cfvPercentile, A1-område eller formel text för cfvFormula). Ignored för cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exempel

Det här exemplet lägger till ett blått datafält över A1:A10 med standardgränser för min/max i intervallet

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

Se även

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
Klasserna TCondFormat / TCondFormatRule