Documentação do HotXLS

Método AddCondFormatDataBar

Adiciona uma regra de formatação condicional de Barra de Dados do Excel 2007+ sobre um intervalo de células, devolvendo o novo TCondFormatRule. Cada célula recebe uma barra de dados colorida cuja largura é proporcional ao valor relativo da célula no intervalo. (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. Cadeia sqref, por exemplo, '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 valores por omissão mapeiam min→cfvMinOfRange e max→cfvMaxOfRange, correspondendo aos limites de barra 'automáticos' predefinidos do Excel
AMinValue / AMaxValue WideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-intervalo or fórmula text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exemplo


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

Ver também