Méthode AddCondFormatDataBar - Référence développeur HotXLS

Ajoute une règle de mise en forme conditionnelle Barre de données Excel 2007+ sur une plage de cellules, renvoyant le nouveau TCondFormatRule. Crée en interne un bloc CONDFMT12 et un enregistrement CF12 lors de l'enregistrement BIFF8 ; pour XLSX, la même règle est rendue via <cfRule type="dataBar">. (Disponible depuis 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 Chaîne, e.g. `'A1:A10'` ou `'B2:C20'`
AColor	LongWord. Couleur de remplissage de la barre au format Delphi BGR (R dans l'octet faible). Pour un remplissage bleu, utilisez $00FF0000; pour un remplissage vert, $0000FF00
AMinKind / AMaxKind	TXLSCfValueKind. Types de seuil: cfvNumber, cfvMinOfRange, cfvMaxOfRange, cfvPercent, cfvPercentile, cfvFormula, cfvAutoMin, cfvAutoMax. Les valeurs par défaut mappent min→cfvMinOfRange et max→cfvMaxOfRange, ce qui correspond aux bornes de barre "automatiques" par défaut d'Excel
AMinValue / AMaxValue	WideString. Threshold literal (numeric texte pour cfvNumber/cfvPercent/cfvPercentile, A1-plage ou formule texte pour cfvFormula). Ignored pour cfvMinOfRange / cfvMaxOfRange / cfvAutoMin / cfvAutoMax

Exemple

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

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

Voir aussi

AddCondFormatColorScale2
AddCondFormatColorScale3
AddCondFormatIconSet
Classes TCondFormat / TCondFormatRule