מתודה AddCondFormatDataBar - מדריך מפתחים של HotXLS

מוסיף כלל עיצוב מותנה של Data Bar של Excel 2007+ על טווח תאים, ומחזיר את ה-TCondFormatRule החדש כדי שניתן יהיה לשפר את כוונון לכל עצירה לפני שמירה. יוצר באופן פנימי בלוק CONDFMT12 ורשומת CF12 בשמירת BIFF8; עבור פלט XLSX אותו כלל מוצג דרך אלמנט OOXML <cfRule type="dataBar">. (זמין החל מגרסה v2.34.0.)

תחביר

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

ARange	WideString. Sqref string, e.g. `'A1:A10'` or `'B2:C20'`
AColor	LongWord. Bar fill color in Delphi BGR format (R in the low byte). For a blue fill use `$00FF0000`; for green `$0000FF00`
AMinKind / AMaxKind	TXLSCfValueKind. Threshold types: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Defaults map min→cfvMinOfRange and max→cfvMaxOfRange, matching Excel's ברירת מחדל "automatic" bar bounds
AMinValue / AMaxValue	WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-טווח or נוסחה text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

דוגמה

דוגמה זו מוסיפה סרגל נתונים כחול על A1:A10 תוך שימוש בגבולות min/max-of-range המוגדרים כברירת מחדל

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

ראה גם

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
מחלקת TXLSWorksheet