Share via

2.6.28 CT_IconSet

  • Article

Target namespace: http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

Referenced by: CT_CfRule

A complex type that specifies the properties of a conditional formatting rule that uses an icon set. The first cfvo element following this element MUST be ignored. There MUST be greater than or equal to three cfvo elements and MUST be less than or equal to five cfvo elements following this complex type.

Child Elements:

cfvo: A CT_Cfvo element that specifies a threshold value between each icon in the icon set.

cfIcon: A CT_CfIcon element that specifies a particular icon to use within an icon set. This element MUST be present if and only if custom equals "true".

Attributes:

iconSet: An ST_IconSetType attribute that specifies the icon set used.

showValue: A Boolean ([XMLSCHEMA2/2] section 3.2.2) attribute that specifies whether the cells in the applied range display the icon and cell value, or the icon only.

Value

Meaning

"true"

The icon and cell value are shown in the cell.

"false"

Only the icon is shown in the cell.

percent: Undefined and MUST be ignored.

reverse: A Boolean ([XMLSCHEMA2/2] section 3.2.2) attribute that specifies whether the icons in the icon set specified in iconSet are shown in reverse order. If custom equals "true" this value MUST be ignored.

Value

Meaning

"true"

The icons specified in iconSet are shown in reverse order.

"false"

The icons specified in iconSet are shown in the order defined by the icon set.

custom: A Boolean ([XMLSCHEMA2/2] section 3.2.2) attribute that specifies whether a custom set of icons is used. If this value is "true", there MUST be the same number of cfIcon elements as cfvo elements and the icons specified by the cfIcon elements are used rather than those specified by iconSet. If this value is "false", there MUST be 0 cfIcon elements.

Value

Meaning

"false"

No custom set of icons is used.

"true"

A custom set of icons is used.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

 <xsd:complexType name="CT_IconSet">
   <xsd:sequence>
     <xsd:element name="cfvo" type="CT_Cfvo" minOccurs="2" maxOccurs="unbounded"/>
     <xsd:element name="cfIcon" type="CT_CfIcon" minOccurs="0" maxOccurs="5"/>
   </xsd:sequence>
   <xsd:attribute name="iconSet" type="ST_IconSetType" use="optional" default="3TrafficLights1"/>
   <xsd:attribute name="showValue" type="xsd:boolean" use="optional" default="true"/>
   <xsd:attribute name="percent" type="xsd:boolean" use="optional" default="true"/>
   <xsd:attribute name="reverse" type="xsd:boolean" use="optional" default="false"/>
   <xsd:attribute name="custom" type="xsd:boolean" use="optional" default="false"/>
 </xsd:complexType>

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).