Metoda AddCondFormatDataBar - Razvijalska referenca HotXLS

Doda pogojno pravilo oblikovanja Podatkovna vrstica (Excel 2007+) za obseg celic in vrne novo pravilo TCondFormatRule, da je mogoče dodelati nastavitve po postanku pred shranjevanjem. Interno ustvari blok CONDFMT12 in zapis CF12 pri shranjevanju BIFF8; za izhod XLSX se isto pravilo upodobi prek elementa OOXML <cfRule type="dataBar">. (Na voljo od v2.34.0.)

Sintaksa

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

ARange	WideString. Niz Sqref, npr. 'A1:A10' ali 'B2:C20'
AColor	LongWord. Barva zapolnitve podatkovne vrstice v formatu Delphi BGR (R je v nizkem bajtu). Za modro polnilo uporabite $00FF0000; za zeleno $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Vrste pragov: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Privzeto se min preslika v cfvMinOfRange in max v cfvMaxOfRange, kar ustreza Excelovim privzetim »samodejnim« mejam vrstice
AMinValue / AMaxValue	WideString. Dobesedna vrednost praga (numerično besedilo za cfvNumber/cfvPercent/cfvPercentile, besedilo obsega A1 ali besedilo formule za cfvFormula). Prezrto za cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Primer

Ta primer doda modro podatkovno vrstico za A1:A10 z uporabo privzetih mej min/max območja

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

Glejte tudi

AddCondFormatColorScale2
\n AddCondFormatColorScale3
\n AddCondFormatIconSet
\n Razreda TCondFormat / TCondFormatRule