AddCondFormatDataBar-method - HotXLS Developer Reference

Adds an Excel 2007+ Data Bar conditional formatting rule over a cell range, returning the new TCondFormatRule afin que le réglage par palier de la règle puisse être affiné avant l'enregistrement. Crée en interne un bloc CONDFMT12 et un enregistrement CF12 à la sauvegarde BIFF8 ; pour une sortie XLSX, la même règle est restituée via l'OOXML <cfRule type="dataBar"> element. (Available since v2.34.0.)

Syntaxe

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'` or `'B2:C20'`
AColor	LongWord. Couleur de remplissage de la barre au format BGR Delphi (R dans l'octet bas). Pour un remplissage bleu, utilisez `$00FF0000`; for green `$0000FF00`
AMinKind / AMaxKind	TXLSCfValueKind. Types de seuils : cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Les valeurs par défaut associent min→cfvMinOfRange et max→cfvMaxOfRange, conformément aux bornes "automatiques" par défaut des barres dans Excel
AMinValue / AMaxValue	WideString. Littéral de seuil (texte numérique pour cfvNumber/cfvPercent/cfvPercentile, plage A1 ou texte de formule pour cfvFormula). Ignoré pour cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exemple

Cet exemple ajoute une barre de données bleue sur A1:A10 en utilisant les bornes par défaut min/max de la plage

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

Voir aussi

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
TCondFormat / TCondFormatRule classes