Documentation HotXLS

Méthode AddCondFormatIconSet

Ajoute une règle de mise en forme conditionnelle Jeu d'icônes Excel 2007+ sur une plage de cellules, renvoyant le nouveau TCondFormatRule. Chaque cellule reçoit l'une des 3, 4 ou 5 icônes de la famille sélectionnée, selon la position de sa valeur dans les seuils de percentile calculés automatiquement. (Disponible depuis v2.34.0.)

Syntaxe

function AddCondFormatIconSet(const ARange: WideString;
  ASetType: TXLSIconSetType): TCondFormatRule;
ARange WideString. Sqref Chaîne, e.g. 'A1:A10'
ASetType TXLSIconSetType. One of the 17 baseline Excel 2007 icon families — icsArrows3 / icsArrows3Gray / icsFlags3 / icsTrafficLights3 / icsTrafficLightsRimmed3 / icsSigns3 / icsSymbols3 / icsSymbolsUncircled3 / icsArrows4 / icsArrows4Gray / icsRedToBlack4 / icsRatings4 / icsTrafficLights4 / icsArrows5 / icsArrows5Gray / icsRatings5 / icsQuarters5. See TXLSIconSetType

Remarques

Les seuils par défaut divisent la plage de valeurs en tranches de percentile égales (3 icônes → 0/33/67, 4 icônes → 0/25/50/75, 5 icônes → 0/20/40/60/80). Utilisez le TCondFormatRule.IconSet retourné pour remplacer des seuils individuels via SetThreshold, ou pour définir Reverse / ShowOnly

Exemple

Cet exemple applique le jeu d'icônes « 3 Flèches (couleur) » sur A1:A10

Sheet.AddCondFormatIconSet('A1:A10', icsArrows3);

Voir aussi