Classe ColorScaleCriterion (Excel VBA)

Cet objet représente les critères pour les seuils minimum, intermédiaire ou maximum d'un format conditionnel de format de couleur.

Set

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

Dim csc as ColorScaleCriterion
Set csc = ActiveCell.FormatConditions(1).ColorScaleCriteria(Index:=1)

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe ColorScaleCriterion : ColorScale.ColorScaleCriteria et ColorScaleCriteria.Item

For Each

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

Dim cscColorScaleCriteria As ColorScaleCriterion
For Each cscColorScaleCriteria In ActiveCell.FormatConditions(1).ColorScaleCriteria
	
Next cscColorScaleCriteria

ColorScaleCriteria.Count

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

Le nombre de critères équivaut au nombre de valeurs de seuil affectées à une échelle de couleur. Il s’agit de deux ou trois, selon que vous utilisez une graduation à deux couleurs ou une mise en forme de trois couleurs pour la règle de mise en forme conditionnelle.

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

ColorScaleCriteria.Item

Cette méthode renvoie un seul objet ColorScaleCriterion de la collection ColorScaleCriteria . 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 d'étendue de couleur. Les critères équivalent aux valeurs de seuil affectées à l'échelle de couleur. 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 ColorScaleCriterion.

Dim cscItem As ColorScaleCriterion
Set cscItem = ActiveCell.FormatConditions(1).ColorScaleCriteria(Index:=1)

FormatColor

Renvoie un objet FormatColor , qui spécifie la couleur affectée au seuil d'un format conditionnel d'étendue de couleur. En lecture seule.

Vous pouvez définir la couleur des seuils minimum, intermédiaire ou maximum sur n'importe quelle couleur personnalisée à l'aide de la propriété Color ou de la propriété ThemeColor de l'objet FormatColor .

Dim fcrFormatColor As FormatColor
Set fcrFormatColor = ActiveCell.FormatConditions(1).ColorScaleCriteria(1).FormatColor

Index

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

Pour une règle de mise en forme conditionnelle d’une forme à deux couleurs, cette propriété renvoie la valeur «1» pour le seuil minimum et «2» pour le seuil maximal. Pour une règle d'échelle de trois couleurs, les valeurs sont « 1 » pour le seuil minimum, « 2 » pour le seuil intermédiaire et « 3 » pour le seuil maximum.

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

Type

Renvoie l'une des constantes de l'énumération XlConditionValueTypes , qui spécifie la façon dont les valeurs de seuil pour un format conditionnel de barre de données ou de couleur sont déterminées. 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 d'une barre de données ou d'une échelle de couleurs peut être un nombre, un pourcentage, une formule ou un centile. Si le type défini est le centile, la fonction Percentile sera utilisée dans Microsoft Excel pour déterminer la valeur de seuil.

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

Value

Renvoie ou définit le minimum, le milieu ou la valeur de seuil maximal pour un format d'échelle de couleur 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).ColorScaleCriteria(1).Value =