HotXLS-dokumentation
Startside Indhold Oversigt

AddCondFormatDataBar metode

Adds an Excel 2007+ Data Bar conditional formatting rule over a cell range, returning the new TCondFormatRule så reglens justering pr. farvestop kan finjusteres før gemning. Internt oprettes en CONDFMT12-blok og en CF12-record ved BIFF8-gemning; til XLSX-output gengives samme regel gennem OOXML- <cfRule type="dataBar"> element. (Available since v2.34.0.)

Syntaks

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. Bjælkeudfyldningens farve i Delphi BGR-format (R i den lave byte). Til blå udfyldning bruges $00FF0000; for green $0000FF00
AMinKind / AMaxKind TXLSCfValueKind. Tærskeltyper: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Standardværdierne mapper min→cfvMinOfRange og max→cfvMaxOfRange, svarende til Excels standardmæssige "automatiske" bjælkegrænser
AMinValue / AMaxValue WideString. Tærskelværdi (numerisk tekst til cfvNumber/cfvPercent/cfvPercentile, A1-område eller formeltekst til cfvFormula). Ignoreres for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Eksempel

Eksemplet tilføjer en blå databjælke over A1:A10 med standardgrænserne min/max af området 

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

Se også

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes