Metoda AddCondFormatDataBar - Dokumentacja deweloperska HotXLS

Dodaje regułę formatowania warunkowego Paska Danych (Excel 2007+) do zakresu komórek, zwracając nową regułę TCondFormatRule, aby można było dostroić parametry per-przystanek przed zapisem. Wewnętrznie tworzy blok CONDFMT12 i rekord CF12 przy zapisie BIFF8; w przypadku wyjścia XLSX ta sama reguła jest renderowana przez element OOXML <cfRule type="dataBar">. (Dostępne od v2.34.0.)

Składnia

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'` lub `'B2:C20'`
AColor	LongWord. Kolor wypełnienia paska w formacie Delphi BGR (R w najmłodszym bajcie). Dla wypełnienia niebieskiego użyj $00FF0000; dla zielonego $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Typy progów: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Domyślne mapowanie to min→cfvMinOfRange i max→cfvMaxOfRange, zgodnie z domyślnymi "automatic" granicami paska w Excel
AMinValue / AMaxValue	WideString. Threshold literal (numeric tekst dla cfvNumber/cfvPercent/cfvPercentile, A1-zakres lub formuła tekst dla cfvFormula). Ignored dla cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Przykład

Ten przykład dodaje niebieski pasek danych nad A1:A10 używając domyślnych granic zakresu min/max

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

Zobacz też

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
Klasy TCondFormat / TCondFormatRule