FormatConditions.AddColorScale method (Excel)

Returns a new ColorScale object representing a conditional formatting rule that uses gradations in cell colors to indicate relative differences in the values of cells included in a selected range.

Syntax

expression.AddColorScale (ColorScaleType)

expression A variable that represents a FormatConditions object.

Parameters

Name	Required/Optional	Data type	Description
ColorScaleType	Required	Long	The type of color scale.

Return value

ColorScale object

Remarks

Color scales are visual guides that help you understand data distribution and variation. A color scale helps you identify relative differences in the values of cells in a given range by using color variation. Different colors and gradations between colors represent differences in cell values.

For example, in a three-color scale, you can specify that cells with the highest relative data values are green, cells with intermediate values are yellow, and cells with the lowest values are red.

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.