ColorScale Interface

Définition

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

public interface class ColorScale
[System.Runtime.InteropServices.Guid("00024493-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ColorScale
Public Interface ColorScale
Attributs

Exemples

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.

<span class="label">Sub CreateColorScaleCF() 































































































































































































































































    Dim cfColorScale As </span>
<i>ColorScale</i>
<span class="label">'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</span>

Remarques

Tous les objets de mise en forme conditionnelle sont contenus dans un objet de collection, qui FormatConditions est un enfant d’une Range collection. Vous pouvez créer une règle de mise en forme d’échelle de couleur à l’aide de la ou des méthodes Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object) AddColorScale(Int32) 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é par la définition des propriétés de ColorScaleCriteria l’objet. L’objet ColorScaleCriteria, qui est un enfant de l’objet ColorScale, est une collection de tous les objets pour l’échelle ColorScaleCriterion de couleurs.

Propriétés

Application

Utilisée sans qualificateur d’objet, cette propriété renvoie un objet qui représente _Application l’Microsoft Office Excel application. Lorsqu’elle est utilisée avec un qualificateur d’objet, elle renvoie un objet Application qui représente l’auteur de l’objet spécifié. En lecture seule.

AppliesTo

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

ColorScaleCriteria

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

Creator

Renvoie une constante dans XlCreator l’éumération qui indique l’application dans laquelle cet objet a été créé. En lecture seule.

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.

Parent

Renvoie l'objet parent de l'objet spécifié. En lecture seule.

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 lorsqu’une feuille de calcul contient plusieurs règles de mise en forme conditionnelle.

PTCondition

Renvoie une valeur de booléen indiquant si la mise en forme conditionnelle est appliquée à un PivotTable graphique. En lecture seule.

ScopeType

Renvoie ou définit l’une des constantes de l’éumération, qui détermine l’étendue de la mise en forme conditionnelle lorsqu’elle est appliquée à un graphique de tableau XlPivotConditionScope croisé dynamique.

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.

Type

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

Méthodes

Delete()

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

ModifyAppliesToRange(Range)

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 la règle de mise en forme conditionnelle de sorte qu’elle soit évaluée après toutes les autres règles présentes dans la feuille de calcul.

S’applique à