Share via

ColorScaleCriterion Object

  • Article
Excel Developer Reference

Represents the criteria for the minimum, midpoint, or maximum thresholds for a color format conditional format.

Version Information
 Version Added:  Excel 2007

Remarks

Each ColorScaleCriterion is part of the ColorScaleCriteria collection. Use ColorScaleCriteria(

index

), to return an individual criterion.

You can set the Type, Value, and FormatColor of each threshold for the color scale.

Example

The following code example creates a range of numbers and then applies a two-color scale conditional formatting rule to that range. The color for the minimum threshold is then assigned to red and the maximum threshold to blue by indexing into the ColorScaleCriteria collection to set individual criteria.

Visual Basic for Applications 
  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

See Also