Metoda AddCondFormatDataBar - Vývojářská reference HotXLS

Přidá pravidlo podmíněného formátování Datový pruh (Excel 2007+) přes rozsah buněk a vrátí nový objekt TCondFormat takže doladění jednotlivých zastávek pravidla lze provést před uložením. Interně vytváří blok CONDFMT12 a záznam CF12 při ukládání BIFF8; pro výstup XLSX se totéž pravidlo vykresluje prostřednictvím OOXML <cfRule type="dataBar"> element. (Available since v2.34.0.)

Syntaxe

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

ARange	WideString. Řetězec Sqref, např. 'A1:A10' nebo 'B2:C20' `'A1:A10'` or `'B2:C20'`
AColor	LongWord. Barva výplně pruhu ve formátu Delphi BGR (R v nejnižším bajtu). Pro modrou výplň použijte $00FF0000; pro zelenou $0000FF00 `$00FF0000`; for green `$0000FF00`
AMinKind / AMaxKind	TXLSCfValueKind. Typy prahů: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Výchozí hodnoty mapují min→cfvMinOfRange a max→cfvMaxOfRange, což odpovídá výchozím „automatickým“ mezím pruhu v Excelu
AMinValue / AMaxValue	WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-oblast or vzorec text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Příklad

Tento příklad přidá modrý datový pruh přes A1:A10 s použitím výchozích mezí min/max rozsahu

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

Viz také

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes