Class IconSetCondition (Excel VBA)

The class IconSetCondition represents an icon set conditional formatting rule.

The main procedures of class IconSetCondition are FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddColorScale, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition, FormatConditions.AddTop10, FormatConditions.AddUniqueValues, FormatConditions.Delete and Delete

Set

To use a IconSetCondition class variable it first needs to be instantiated, for example

Dim isc as IconSetCondition
Set isc = ActiveCell.FormatConditions(Index:=1)

The following procedures can be used to set variables of type IconSetCondition: Range.FormatConditions, FormatConditions.AddIconSetCondition, FormatConditions.AddIconSetCondition, FormatConditions.AddIconSetCondition, FormatConditions.AddIconSetCondition, FormatConditions.AddIconSetCondition, FormatConditions.AddIconSetCondition and FormatConditions.AddIconSetCondition

For Each

Here is an example of processing the IconSetCondition items in a collection.

Dim iscFormatCondition As IconSetCondition
For Each iscFormatCondition In ActiveCell.FormatConditions
	
Next iscFormatCondition

Themes

The following procedures in this class have been grouped together and are described on a separate theme page

Add with its procedures FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition and FormatConditions.AddTop10

Methods

These are the main methods of the IconSetCondition class

FormatConditions.AddColorScale - Returns a new ColorScale colorscale 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.

Dim lngColorScaleType As Long: lngColorScaleType = 
Dim cseAddColorScale As ColorScale
Set cseAddColorScale = ActiveCell.FormatConditions.AddColorScale(ColorScaleType:=lngColorScaleType)

FormatConditions.AddUniqueValues - Returns a new UniqueValues uniquevalues representing a conditional formatting rule for the specified range.

Dim uvsAddUniqueValues As UniqueValues
Set uvsAddUniqueValues = ActiveCell.FormatConditions.AddUniqueValues()

FormatConditions.Delete - Deletes the object.

ActiveCell.FormatConditions.Delete

Delete - Deletes the specified conditional formatting rule object.

ActiveCell.FormatConditions(1).Delete

Other Methods

FormatConditions.Item - Returns a single object from a collection.

ModifyAppliesToRange - Sets the cell range to which this formatting rule applies.

SetFirstPriority - Sets the priority value for this conditional formatting rule to 1 so that it will be evaluated before all other rules on the worksheet.

SetLastPriority - Sets the evaluation order for this conditional formatting rule so that it is evaluated after all other rules on the worksheet.

Properties

FormatConditions.Count returns a Long value that represents the number of objects in the collection.

FormatConditions.Parent returns the parent object for the specified object. Read-only.

AppliesTo returns a Range object specifying the cell range to which the formatting rule is applied.

Formula returns or sets a String representing a formula, which determines the values to which the icon set will be applied.

IconCriteria returns an IconCriteria collection, which represents the set of criteria for an icon set conditional formatting rule.

IconSet returns or sets an IconSets collection, which specifies the icon set used in the conditional format.

Parent returns the parent object for the specified object. Read-only.

PercentileValues returns or sets a Boolean value indicating if the thresholds for an icon set conditional format are determined by using percentiles.

Priority returns or sets the priority value of the conditional formatting rule. The priority determines the order of evaluation when multiple conditional formatting rules exist on a worksheet.

PTCondition returns a Boolean value indicating if the conditional format is being applied to a PivotTable.

ReverseOrder returns or sets a Boolean value indicating if the order of icons is reversed for an icon set.

ScopeType returns or sets one of the constants of the XlPivotConditionScope enumeration, which determines the scope of the conditional format when it is applied to a PivotTable.

ShowIconOnly returns or sets a Boolean value indicating if only the icon is displayed for an icon set conditional format.

StopIfTrue returns or sets a Boolean value that determines if additional formatting rules on the cell should be evaluated if the current rule evaluates to True.

Type returns one of the constants of the XlFormatConditionType enumeration, which specifies the type of conditional format.