Método AddCondFormatDataBar - Referencia para desarrolladores de HotXLS

Adds an Excel 2007+ Data Bar de formato condicional sobre un rango de celdas, devolviendo la nueva TCondFormatRule para que el ajuste por punto de la regla pueda afinarse antes de guardar. Internamente crea un bloque CONDFMT12 y un registro CF12 al guardar en BIFF8; para la salida XLSX la misma regla se representa a través del elemento OOXML <cfRule type="dataBar"> Añade una regla de formato condicional de Barra de datos de Excel 2007+ sobre un rango de celdas, devolviendo el nuevo TCondFormatRule. (Disponible desde v2.34.0.)

Sintaxis

function AddCondFormatDataBar(const ARange: WideString;
  AColor: LongWord;
  AMinKind: TXLSCfValueKind = cfvMinOfRange; const AMinValue: WideString = '';
  AMaxKind: TXLSCfValueKind = cfvMaxOfRange; const AMaxValue: WideString = ''): TCondFormatRule;

ARange	WideString. Sqref Cadena, e.g. `'A1:A10'` o `'B2:C20'`
AColor	LongWord. Color de relleno de la barra en formato Delphi BGR (R en el byte bajo). Para un relleno azul usa $00FF0000; para verde $0000FF00 `$00FF0000`; for green `$0000FF00`
AMinKind / AMaxKind	TXLSCfValueKind. Tipos de umbral: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Los valores predeterminados asignan min→cfvMinOfRange y max→cfvMaxOfRange, siguiendo los límites de barra automáticos predeterminados de Excel
AMinValue / AMaxValue	WideString. Threshold literal (numeric texto para cfvNumber/cfvPercent/cfvPercentile, A1-rango o fórmula texto para cfvFormula). Ignored para cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Ejemplo

AddCondFormatColorScale2

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

Véase también

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes