AddCondFormatDataBar-metodi - HotXLS-kehittäjäviite

Lisää Excel 2007+ Datapalkit-ehdollisen muotoilusäännön solualueen päälle palauttaen uuden TCondFormatRule-objektin, jotta säännön pysähdyskohtaisia säätöjä voidaan tarkentaa ennen tallennusta. Luo sisäisesti CONDFMT12-lohkon ja CF12-tietueen BIFF8-tallennuksessa; XLSX-tulosteessa sama sääntö renderöidään OOXML:n <cfRule type="dataBar">-elementin kautta. (Saatavilla v2.34.0:sta alkaen.)

Syntaksi

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

ARange	WideString. Sqref-merkkijono, esimerkiksi 'A1:A10' tai 'B2:C20'
AColor	LongWord. Palkin täyttöväri Delphin BGR-muodossa (R on alimmassa tavussa). Sininen täyttö on $00FF0000; vihreä $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Kynnysarvotyypit: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Oletukset vastaavat min→cfvMinOfRange ja max→cfvMaxOfRange, mikä vastaa Excelin oletusarvoisia "automatic"-palkin rajoja
AMinValue / AMaxValue	WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-alue or kaava text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Esimerkki

Tässä esimerkissä lisätään sininen datapalkki A1:A10-alueelle käyttäen oletusarvoisia alueen minimi/maksimi-rajoja

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

Katso myös

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule -luokat