Метод 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, наприклад '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
AMinValue / AMaxValue	WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-діапазон or формула text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Приклад

Цей приклад додає синю панель даних над A1:A10 з використанням стандартних меж мінімум/максимум діапазону

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

Дивіться також

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
Класи TCondFormat / TCondFormatRule