Version

IconCriterion Class

Defines the criterion for an IconSetConditionalFormat threshold.
Syntax
'Declaration
 
Public NotInheritable Class IconCriterion 
   Inherits CriterionBase
public sealed class IconCriterion : CriterionBase 
Remarks

This class provides the ability to override the default behavior of the associated condition for the threshold defined by this instance.

For example, the icon displayed for cell values which fall within this threshold is determined by the value of the IconSetConditionalFormat.IconSet, but can be overridden using the Icon property.

Similarly, the default unit for this criterion's value is percentage, but this can be overridden using the ValueType property. For example, to define the unit for the value as a specific number, assign a value of Number to the ValueType property.

The value for this threshold is defined by the parent condition, based on the total number of thresholds. For IconSetConditionalFormat.IconSet values which yield three thresholds, for example, the effective value is dependent on the threshold, so that each threshold represents approximately 33% of the associated range. This can be overridden using the Value property; for example, setting the ValueType property to Number and the Value property to a specific number overrides the behavior as defined by the parent condition, and forces the threshold boundary to the specific numeric value.

For this reason, the Icon, Value, and ValueType properties support null values, and are in fact set to null by default; this is interpreted by the parent condition as "not set", resulting in the threshold criterion being determined solely by the parent condition.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also