Метод AddCondFormatDataBar - Справочник разработчика HotXLS

Добавляет правило условного форматирования Гистограмма (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'` или `'B2:C20'`
AColor	LongWord. Цвет заливки полосы в формате Delphi BGR (R в младшем байте). Для синей заливки используйте $00FF0000; для зелёной $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Типы порогов: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Значения по умолчанию сопоставляют min→cfvMinOfRange и max→cfvMaxOfRange, что соответствует границам полосы Excel по умолчанию "automatic"
AMinValue / AMaxValue	WideString. Threshold literal (numeric текст для cfvNumber/cfvPercent/cfvPercentile, A1-диапазон или формула текст для cfvFormula). Ignored для cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Пример

Данный пример добавляет синюю гистограмму для A1:A10 с границами по умолчанию (минимум/максимум диапазона)

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

См. также

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
Классы TCondFormat / TCondFormatRule