AddCondFormatDataBar metodas - HotXLS kūrėjo žinynas

Prideda „Excel 2007+" duomenų juostos sąlyginio formatavimo taisyklę virš langelių diapazono, grąžindamas naują TCondFormatRule, kad galima būtų tikslinti taisyklės parametrus prieš išsaugant. Viduje sukuria CONDFMT12 bloką ir CF12 įrašą BIFF8 išsaugojimo metu; XLSX išvestyje ta pati taisyklė atvaizduojama per OOXML <cfRule type="dataBar"> elementą. (Pasiekiama nuo v2.34.0.)

Sintaksė

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

ARange	WideString. Sqref eilutė, pvz. 'A1:A10' arba 'B2:C20'
AColor	LongWord. Juostos užpildo spalva Delphi BGR formatu (R yra mažiausiai reikšmingame baite). Mėlynam užpildui naudokite $00FF0000; žaliam $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Slenksčių tipai: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Numatytieji nustatymai susieja min→cfvMinOfRange ir max→cfvMaxOfRange, atitinka Excel numatytąsias "automatic" juostos ribas
AMinValue / AMaxValue	WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-sritis or formulė text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Pavyzdys

AddCondFormatColorScale2
\n AddCondFormatColorScale3
\n AddCondFormatIconSet
\n TCondFormat / TCondFormatRule klasės

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

Taip pat žr

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes