Classe IconCriterion (Excel VBA)

Cet objet représente le critère d’une icône individuelle dans un jeu d’icônes.

Set

Pour utiliser une variable de classe IconCriterion, elle doit d'abord être instanciée, par exemple

Dim icncrt as IconCriterion
Set icncrt = ActiveCell.FormatConditions(1).IconCriteria(Index:=1)

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe IconCriterion : IconSetCondition.IconCriteria et IconCriteria.Item

For Each

Voici un exemple de traitement des éléments IconCriterion dans une collection

Dim icncrtIconCriteria As IconCriterion
For Each icncrtIconCriteria In ActiveCell.FormatConditions(1).IconCriteria
	
Next icncrtIconCriteria

IconCriteria.Count

Renvoie une valeur de type long qui spécifie le nombre de critères d’une règle de mise en forme conditionnelle de jeu d’icônes. En lecture seule.

Le nombre de critères équivaut au nombre de valeurs de seuil affectées à un jeu d'icônes.

Dim lngCount As Long
lngCount = ActiveCell.FormatConditions(1).IconCriteria.Count

IconCriteria.Item

Cette méthode renvoie un seul objet IconCriterion de la collection IconCriteria, . En lecture seule.

La valeur du paramètre Index ne peut pas être supérieure au nombre de critères définis pour un format conditionnel de jeu d'icônes. Les critères équivalent aux valeurs de seuil affectées au jeu d'icônes. Pour calculer le nombre de valeurs de seuil, utilisez la propriété Count .

Syntaxe : expression.Item (Index)

Index: Numéro d'index de l'objet IconCriterion.

Dim icncrtItem As IconCriterion
Set icncrtItem = ActiveCell.FormatConditions(1).IconCriteria(Index:=1)

Icon

Renvoie ou définit l’icône d’un critère dans une règle de mise en forme conditionnelle de jeu d’icônes. Lecture-écriture.

Valeurs possibles sont xlIcon0Bars - Indicateur de signal sans barres pleines, xlIcon0FilledBoxes - Zéro zone de remplissage, xlIcon1Bar - Indicateur de signal avec une barre pleine, xlIcon1FilledBox - Une zone de remplissage, xlIcon2Bars - Indicateur de signal avec deux barres pleines, xlIcon2FilledBoxes - Deux zones de remplissage, xlIcon3Bars - Indicateur de signal avec trois barres pleines, xlIcon3FilledBoxes - Trois zones de remplissage, xlIcon4Bars - Indicateur de signal avec quatre barres pleines, xlIcon4FilledBoxes - Quatre zones de remplissage, xlIconBlackCircle - Cercle noir, xlIconBlackCircleWithBorder - Cercle noir avec bordure, xlIconCircleWithOneWhiteQuarter - Cercle avec un quartier blanc, xlIconCircleWithThreeWhiteQuarters - Cercle avec trois quartiers blancs, xlIconCircleWithTwoWhiteQuarters - Cercle avec deux quartiers blancs, xlIconGoldStar - Étoile dorée, xlIconGrayCircle - Cercle gris, xlIconGrayDownArrow - Flèche bas grise, xlIconGrayDownInclineArrow - Flèche inclinée bas grise, xlIconGraySideArrow - Flèche côté grise, xlIconGrayUpArrow - Flèche haut grise, xlIconGrayUpInclineArrow - Flèche inclinée haut grise, xlIconGreenCheck - Coche verte, xlIconGreenCheckSymbol - Coche verte, xlIconGreenCircle - Cercle vert, xlIconGreenFlag - Indicateur vert, xlIconGreenTrafficLight - Feu vert, xlIconGreenUpArrow - Flèche haut verte, xlIconGreenUpTriangle - Triangle vert vers le haut, xlIconHalfGoldStar - Étoile semi-dorée, xlIconNoCellIcon - Aucune icône de cellule, xlIconPinkCircle - Cercle rose, xlIconRedCircle - Cercle rouge, xlIconRedCircleWithBorder - Cercle rouge avec bordure, xlIconRedCross - Croix rouge, xlIconRedCrossSymbol - Croix rouge, xlIconRedDiamond - Losange rouge, xlIconRedDownArrow - Flèche bas rouge, xlIconRedDownTriangle - Triangle rouge vers le bas, xlIconRedFlag - Indicateur rouge, xlIconRedTrafficLight - Feu rouge, xlIconSilverStar - Étoile argentée, xlIconWhiteCircleAllWhiteQuarters - Cercle blanc (quartiers blancs), xlIconYellowCircle - Cercle jaune, xlIconYellowDash - Trait jaune, xlIconYellowDownInclineArrow - Flèche inclinée bas jaune, xlIconYellowExclamation - Point d’exclamation jaune, xlIconYellowExclamationSymbol - Point d’exclamation jaune, xlIconYellowFlag - Indicateur jaune, xlIconYellowSideArrow - Flèche côté jaune, xlIconYellowTrafficLight - Feu orange, xlIconYellowTriangle - Triangle jaune, xlIconYellowUpInclineArrow - Flèche inclinée haut jaune.

Une fois que vous avez défini la propriété Icon pour le critère d'icône dans une règle de mise en forme conditionnelle de jeu d'icônes, la propriété IconSet de l'objet IconSetCondition est changée en xlCustomSet.

ActiveCell.FormatConditions(1).IconCriteria(1).Icon = xlIcon0Bars

Index

Renvoie une valeur de type Long indiquant le seuil que représentent les critères. En lecture seule.

Pour un jeu d'icônes, cette propriété renvoie une valeur de 1 pour le seuil minimal, 2 pour le seuil suivant, et ainsi de suite.

Dim lngIndex As Long
lngIndex = ActiveCell.FormatConditions(1).IconCriteria(1).Index

Operator

Cette propriété renvoie ou définit l'une des constantes de l'énumération XlFormatConditionOperator , qui spécifie si le seuil est «supérieur à» ou «supérieur ou égal à» la valeur de seuil.

Pour une règle de mise en forme conditionnelle de jeu d'icônes, cette propriété ne peut utiliser que l'une des deux constantes suivantes : xlGreater ou xlGreaterEqual.

ActiveCell.FormatConditions(1).IconCriteria(1).Operator =

Type

Renvoie l'une des constantes de l'énumération XlConditionValueTypes , qui spécifie comment la valeur de seuil d'un jeu d'icônes est déterminée. En lecture seule.

Valeurs possibles sont xlConditionValueAutomaticMax - La barre de données la plus longue est proportionnelle à la valeur maximale de la plage, xlConditionValueAutomaticMin - La barre de données la plus courte est proportionnelle à la valeur minimale de la plage, xlConditionValueFormula - La formule est utilisée, xlConditionValueHighestValue - Valeur la plus élevée d’une liste, xlConditionValueLowestValue - Valeur la plus faible d’une liste, xlConditionValueNone - Aucune valeur conditionnelle, xlConditionValueNumber - Le numéro est utilisé, xlConditionValuePercent - Le pourcentage est utilisé, xlConditionValuePercentile - Le centile est utilisé.

Le type de valeur de seuil pour un jeu d'icônes peut être un nombre, un pourcentage, une formule ou un centile. Si le type est défini sur centile, la fonction percentile est utilisée dans Excel pour déterminer la valeur de seuil.

ActiveCell.FormatConditions(1).IconCriteria(1).Type = xlConditionValueAutomaticMax

Value

Renvoie ou définit la valeur de seuil pour un icône dans un format conditionnel. Variant en lecture/écriture.

Vous ne pouvez définir la valeur que si la propriété type pour le format conditionnel est définie sur l'une des constantes XlConditionValueTypes suivantes: xlConditionValueNumber, xlConditionValuePercent, ** xlConditionValuePercentile**ou xlConditionValueFormula. Si le type de seuil est une formule, vous pouvez définir la formule en tant que String. La formule doit renvoyer un seul nombre.

ActiveCell.FormatConditions(1).IconCriteria(1).Value =