HotXLS-dokumentation
Startsida Innehåll Översikt

AddCondFormatDataBar metod

Adds an Excel 2007+ Data Bar conditional formatting rule over a cell range, returning the new TCondFormatRule så att regelns finjustering per stopp kan förfinas före sparning. Skapar internt ett CONDFMT12-block och en CF12-post vid BIFF8-sparning; för XLSX-utdata renderas samma regel genom OOXML <cfRule type="dataBar"> element. (Available since 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' or 'B2:C20'
AColor LongWord. Stapelfyllnadsfärg i Delphi BGR-format (R i lågbyte). För blå fyllnad använder du $00FF0000; for green $0000FF00
AMinKind / AMaxKind TXLSCfValueKind. Tröskeltyper: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Standardvärdena mappar min→cfvMinOfRange och max→cfvMaxOfRange, vilket motsvarar Excels standard "automatiska" stapelgränser
AMinValue / AMaxValue WideString. Tröskelvärde (numerisk text för cfvNumber/cfvPercent/cfvPercentile, A1-område eller formeltext för cfvFormula). Ignoreras för cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exempel

Exemplet lägger till en blå databar över A1:A10 med standardgränserna min/max av området 

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

Se även

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes