Metoda AddCondFormatDataBar - Referință pentru dezvoltatori HotXLS

Adaugă o regulă de formatare condiționată Data Bar Excel 2007+ peste un interval de celule, returnând noul TCondFormatRule astfel încât ajustarea per-oprire a regulii să poată fi rafinată înainte de salvare. Intern creează un bloc CONDFMT12 și o înregistrare CF12 la salvarea BIFF8; pentru ieșire XLSX aceeași regulă este redată prin elementul OOXML <cfRule type="dataBar">. (Disponibil din v2.34.0.)

Sintaxă

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

ARange	WideString. Șir Sqref, de exemplu A1:A10 sau B2:C20
AColor	LongWord. Culoarea de umplere a barei în format Delphi BGR (R în octetul inferior). Pentru o umplere albastră folosiți $00FF0000; pentru verde $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Tipuri de prag: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Valorile implicite mapate sunt min→cfvMinOfRange și max→cfvMaxOfRange, potrivite cu limitele automate implicite din Excel
AMinValue / AMaxValue	WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-interval or formulă text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exemplu

Acest exemplu adaugă o bară de date albastră peste A1:A10 utilizând limitele implicite min/max ale intervalului

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

Vezi și

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
Clasele TCondFormat / TCondFormatRule