Classe ColorScale (Excel VBA)

Cet objet représente une règle de mise en forme conditionnelle d’échelle de couleur.

Les procédures principales de la classe ColorScale sont Delete, FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddColorScale, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition, FormatConditions.AddTop10, FormatConditions.AddUniqueValues et FormatConditions.Delete

Set

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

Dim cse as ColorScale
Set cse = ActiveCell.FormatConditions(Index:=1)

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe ColorScale : FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale, FormatConditions.AddColorScale et Range.FormatConditions

For Each

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

Dim cseFormatCondition As ColorScale
For Each cseFormatCondition In ActiveCell.FormatConditions
	
Next cseFormatCondition

Thèmes

Les procédures suivantes de cette classe ont été regroupées et sont décrites sur une page thématique séparée

Add with its procedures FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition et FormatConditions.AddTop10

Méthodes

Les méthodes principales de la classe ColorScale sont

Delete - Supprime l’objet de règle de mise en forme conditionnelle spécifié.

ActiveCell.FormatConditions(1).Delete

FormatConditions.AddColorScale - Cette méthode renvoie un nouvel objet ColorScale qui représente une règle de mise en forme conditionnelle qui utilise des dégradés dans les couleurs des cellules pour indiquer les différences relatives entre les valeurs des cellules incluses dans une plage sélectionnée.

Dim lngColorScaleType As Long: lngColorScaleType = 
Dim cseAddColorScale As ColorScale
Set cseAddColorScale = ActiveCell.FormatConditions.AddColorScale(ColorScaleType:=lngColorScaleType)

FormatConditions.AddUniqueValues - Renvoie un nouvel objet UniqueValues qui représente une règle de mise en forme conditionnelle pour la plage spécifiée.

Dim uvsAddUniqueValues As UniqueValues
Set uvsAddUniqueValues = ActiveCell.FormatConditions.AddUniqueValues()

FormatConditions.Delete - Cette méthode supprime l'objet.

ActiveCell.FormatConditions.Delete

Autre Méthodes

ModifyAppliesToRange - Définit la plage de cellules à laquelle cette règle de mise en forme s’applique.

SetFirstPriority - Attribue à la règle de mise en forme conditionnelle en question la valeur de priorité « 1 » de sorte qu’elle soit évaluée avant toutes les autres règles présentes dans la feuille de calcul.

SetLastPriority - Définit l’ordre d’évaluation de cette règle de mise en forme conditionnelle de sorte qu’elle soit évaluée après toutes les autres règles de la feuille de calcul.

FormatConditions.Item - Cette méthode renvoie un seul objet d'une collection.

Propriétés

AppliesTo Renvoie un objet Range qui spécifie la plage de cellules à laquelle la règle de mise en forme est appliquée.

Dim rngAppliesTo As Range
Set rngAppliesTo = ActiveCell.FormatConditions(1).AppliesTo

ColorScaleCriteria Renvoie un objet ColorScaleCriteria , qui est une collection d'objets ColorScaleCriterion individuels. L'objet ColorScaleCriterion spécifie le type, la valeur et la couleur des critères de seuil utilisés dans le format conditionnel de l'étendue de couleur. En lecture seule.

Dim cscColorScaleCriteria As ColorScaleCriteria
Set cscColorScaleCriteria = ActiveCell.FormatConditions(1).ColorScaleCriteria

Formula Renvoie ou définit une valeur de type String représentant une formule qui détermine les valeurs auxquelles sera appliqué le jeu d’icônes.

ActiveCell.FormatConditions(1).Formula =

Parent Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

Dim objParent As Object
Set objParent = ActiveCell.FormatConditions(1).Parent

Priority Renvoie ou définit la valeur de priorité de la règle de mise en forme conditionnelle. La priorité détermine l’ordre d’évaluation lorsque plusieurs règles de mise en forme conditionnelle existent dans une feuille de calcul.

ActiveCell.FormatConditions(1).Priority =

PTCondition Renvoie une valeur de type Boolean indiquant si le format conditionnel est appliqué à un tableau croisé dynamique. En lecture seule.

Dim booPTCondition As Boolean
booPTCondition = ActiveCell.FormatConditions(1).PTCondition

ScopeType Cette propriété renvoie ou définit l'une des constantes de l'énumération XlPivotConditionScope , qui détermine l'étendue du format conditionnel lorsqu'il est appliqué à un tableau croisé dynamique.

ActiveCell.FormatConditions(1).ScopeType = xlDataFieldScope

StopIfTrue Renvoie ou définit une valeur de type Boolean qui détermine si les autres règles de mise en forme conditionnelle de la cellule doivent être évaluées lorsque la règle active renvoie la valeur True.

Dim booStopIfTrue As Boolean
booStopIfTrue = ActiveCell.FormatConditions(1).StopIfTrue

Type Renvoie l'une des constantes de l'énumération XlFormatConditionType , qui spécifie le type de mise en forme conditionnelle. En lecture seule.

Dim xlfcType As XlFormatConditionType
xlfcType = ActiveCell.FormatConditions(1).Type

FormatConditions.Count Cette propriété renvoie une valeur de type Long qui représente le nombre d’objets de la collection.

Dim lngCount As Long
lngCount = ActiveCell.FormatConditions.Count

FormatConditions.Parent Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

Dim objParent As Object
Set objParent = ActiveCell.FormatConditions.Parent