Documentação do HotXLS
InícioConteúdoVisão geral

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 para que a afinação ponto a ponto da regra possa ser refinada antes de gravar. Internamente cria um bloco CONDFMT12 e um registo CF12 ao gravar em BIFF8; para saída XLSX, a mesma regra é renderizada através do OOXML <cfRule type="dataBar"> . 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;
ARangeWideString. Cadeia sqref, por exemplo, 'A1:A10' ou 'B2:C20' 'A1:A10' or 'B2:C20'
AColorLongWord. Cor de preenchimento da barra no formato BGR do Delphi (R no byte menos significativo). Para um preenchimento azul use $00FF0000; para verde $0000FF00 $00FF0000; for green $0000FF00
AMinKind / AMaxKindTXLSCfValueKind. 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 / AMaxValueWideString. Threshold literal (numeric text for cfvNumber/cfvPercent/cfvPercentile, A1-intervalo or fórmula text for cfvFormula). Ignored for cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exemplo

AddCondFormatColorScale2 

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

Ver também

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes