Objet ColorScale (Excel)

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

Remarques

Tous les objets de mise en forme conditionnelle sont contenus dans un objet de collection FormatConditions , qui est un enfant d’une collection Range . Vous pouvez créer une règle de mise en forme d’échelle de couleurs à l’aide de la méthode Add ou AddColorScale de la collection FormatConditions .

Les échelles de couleur sont des repères visuels qui vous aident à comprendre la répartition et la variation des données. Vous pouvez appliquer une échelle de deux ou de trois couleurs à une plage de données, aux données d'un tableau ou aux données d'un rapport de tableau croisé dynamique. Pour un format conditionnel d'échelle à deux couleurs, attribuez la valeur, le type et la couleur aux seuils minimum et maximum d'une plage. Une échelle de trois couleurs possède aussi un seuil intermédiaire.

Chacun de ces seuils est déterminé en définissant les propriétés de l’objet ColorScaleCriteria . L'objet ColorScaleCriteria, qui est subordonné à l'objet ColorScale, est une collection de tous les objets ColorScaleCriterion de l'échelle de couleur.

Exemple

L'exemple de code suivant crée une plage de nombres et lui applique une règle de mise en forme conditionnelle d'échelle de deux couleurs. La couleur du seuil minimum est ensuite réglée sur le rouge et le seuil maximum sur le bleu.

Sub CreateColorScaleCF() 
 
 Dim cfColorScale As ColorScale 
 
 'Fill cells with sample data from 1 to 10 
 With ActiveSheet 
 .Range("C1") = 1 
 .Range("C2") = 2 
 .Range("C1:C2").AutoFill Destination:=Range("C1:C10") 
 End With 
 
 Range("C1:C10").Select 
 
 'Create a two-color ColorScale object for the created sample data range 
 Set cfColorScale = Selection.FormatConditions.AddColorScale(ColorScaleType:=2) 
 
 'Set the minimum threshold to red and maximum threshold to blue 
 cfColorScale.ColorScaleCriteria(1).FormatColor.Color = RGB(255, 0, 0) 
 cfColorScale.ColorScaleCriteria(2).FormatColor.Color = RGB(0, 0, 255) 
 
End Sub

Méthodes

Propriétés

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.