Edit

Share via


IconSetCondition Interface

Definition

Represents an icon set conditional formatting rule.

public interface class IconSetCondition
[System.Runtime.InteropServices.Guid("00024497-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface IconSetCondition
Public Interface IconSetCondition
Attributes

Remarks

All conditional formatting objects are contained within a FormatConditions collection object, which is a child of a Range collection. You can create an icon set formatting rule by using either the Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object) method or AddIconSetCondition() method of the FormatConditions collection.

Each icon set contains three, four, or five icons. You use the IconSets property of the _Workbook object to return an IconSets object to specify one of the built-in icon sets. Each individual icon in the icon set is then assigned to a subset of the values of the range by the members of the IconCriteria obect. The type of threshold is also specified by this object.

Properties

Application

When used without an object qualifier, this property returns an _Application object that represents the Microsoft Office Excel application. When used with an object qualifier, this property returns an Application object that represents the creator of the specified object. Read-only.

AppliesTo

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

Creator

Returns a 32-bit integer equivalent to an XlCreator value that indicates the application in which this object was created. Read-only.

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 in a worksheet.

PTCondition

Returns a Boolean value indicating if the conditional format is being applied to a PivotTable chart. Read-only.

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 chart.

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. Read-only.

Methods

Delete()

Deletes the specified conditional formatting rule object.

ModifyAppliesToRange(Range)

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 it is evaluated after all other rules on the worksheet.

Applies to