ColorScale Interface

Référence

Définition

Espace de noms:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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: GuidAttribute InterfaceTypeAttribute

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 FormatConditions objet de collection, qui est un enfant d’une Range collection. Vous pouvez créer une règle de mise en forme d’échelle de couleurs à l’aide de la Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object) méthode ou 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é en définissant les propriétés de l’objet ColorScaleCriteria . L’objet ColorScaleCriteria , qui est un enfant de l’objet ColorScale , est une collection de tous les objets de l’échelle ColorScaleCriterion de couleurs.

Propriétés

Application	Lorsqu’elle est utilisée sans qualificateur d’objet, cette propriété renvoie un _Application objet qui représente l’application Microsoft Office Excel. 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	Retourne un Range objet spécifiant la plage de cellules à laquelle la règle de mise en forme est appliquée.
ColorScaleCriteria	Retourne un ColorScaleCriteria objet, qui est une collection d’objets individuels ColorScaleCriterion . 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’échelle de couleurs. En lecture seule.
Creator	Retourne une constante dans l’énumération XlCreator 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 pour 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	Retourne une valeur booléenne indiquant si le format conditionnel est appliqué à un PivotTable graphique. En lecture seule.
ScopeType	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 graphique de tableau 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	Retourne l’une des constantes de l’énumération XlFormatConditionType , qui spécifie le type de format conditionnel. 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 à