AddCondFormatDataBar methode - HotXLS ontwikkelaarsreferentie

Voegt een Excel 2007+ Gegevensbalk-regel voor voorwaardelijke opmaak toe over een celbereik, en geeft de nieuwe TCondFormatRule terug zodat de per-stop afstemming van de regel verfijnd kan worden vóór opslaan. Intern wordt een CONDFMT12-blok en een CF12-record gemaakt bij BIFF8-opslaan; voor XLSX-uitvoer wordt dezelfde regel weergegeven via het OOXML <cfRule type="dataBar">-element. (Beschikbaar sinds v2.34.0.)

Syntaxis

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'` van `'B2:C20'`
AColor	LongWord. Balkvulkleur in Delphi BGR-opmaak (R in de laagste byte). Gebruik voor een blauwe vulling $00FF0000; voor groen $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Drempeltypen: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Standaardtoewijzingen: min→cfvMinOfRange en max→cfvMaxOfRange, overeenkomstig de standaard automatische balkgrenzen van Excel
AMinValue / AMaxValue	WideString. Threshold literal (numeric tekst voor cfvNumber/cfvPercent/cfvPercentile, A1-bereik van formule tekst voor cfvFormula). Ignored voor cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Voorbeeld

Dit voorbeeld voegt een blauwe gegevensbalk toe over A1:A10 met de standaard min/max-van-bereik grenzen

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

Zie ook

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule klassen