Método AddCondFormatDataBar - Referência de desenvolvedor HotXLS

Adiciona uma regra de formatação condicional de Barra de Dados do Excel 2007+ sobre um intervalo de células, retornando o novo TCondFormatRule para que o ajuste por parada da regra possa ser refinado antes do salvamento. Internamente cria um bloco CONDFMT12 e um registro CF12 no salvamento BIFF8; para saída XLSX, a mesma regra é renderizada pelo elemento OOXML <cfRule type="dataBar">. (Disponível desde v2.34.0.)

Sintaxe

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'` ou `'B2:C20'`
AColor	LongWord. Cor de preenchimento da barra no formato BGR do Delphi (R no byte menos significativo). Para um preenchimento azul use $00FF0000; para verde $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Tipos de limite: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Os padrões mapeiam min → cfvMinOfRange e max → cfvMaxOfRange, correspondendo aos limites automáticos padrão da barra do Excel
AMinValue / AMaxValue	WideString. Threshold literal (numeric texto para cfvNumber/cfvPercent/cfvPercentile, A1-intervalo ou fórmula texto para cfvFormula). Ignored para cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exemplo

Este exemplo adiciona uma barra de dados azul sobre A1:A10 usando os limites padrão de mínimo/máximo do intervalo

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

Veja também

AddCondFormatColorScale2
\n AddCondFormatColorScale3
\n AddCondFormatIconSet
\n Classes TCondFormat / TCondFormatRule