AddCondFormatDataBar metódus - HotXLS fejlesztői referencia

Egy Excel 2007+ Adatsáv feltételes formázási szabályt ad egy cellatartományra, és visszaadja az új TCondFormatRule objektumot, hogy a szabály megállónkénti finomhangolása mentés előtt elvégezhető legyen. Belsőleg létrehoz egy CONDFMT12 blokkot és egy CF12 rekordot BIFF8 mentéskor; XLSX kimenetre ugyanez a szabály az OOXML <cfRule type="dataBar"> elem segítségével kerül megjelenítésre. (Elérhető v2.34.0 óta.)

Szintaxis

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

ARange	WideString. Sqref sztring, például 'A1:A10' vagy 'B2:C20'
AColor	LongWord. Oszlopkitöltő szín Delphi BGR formátumban (a piros az alacsony bájtban). Kék kitöltéshez használja a $00FF0000 értéket; zöldhöz a $0000FF00-at
AMinKind / AMaxKind	TXLSCfValueKind. Küszöbtípusok: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Az alapértelmezett leképezés min→cfvMinOfRange és max→cfvMaxOfRange, ami megegyezik az Excel alapértelmezett „automatikus” sávhatáraival
AMinValue / AMaxValue	WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-tartomány or képlet text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Példa

Ez a példa kék adatsávot ad az A1:A10 cellákhoz az alapértelmezett min/max-tartomány határok használatával

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

Lásd még

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule osztályok