[ms-xlsx]: Excel (. xlsx) Extensions to the Office Open xml spreadsheetml file Format Intellectual Property Rights Notice for Open Specifications Documentation

1674.1.1CT_IconFilter

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

Referenced by: iconFilter

This complex type specifies the icon set and particular icon within that set to filter by. Rows with a cell icon that do not match these criteria will be hidden when the filter is applied.

Attributes:

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

iconId: An unsignedInt ([XMLSCHEMA2] section 3.3.22) attribute that specifies the index of the icon to be used as filter criteria. If iconSet is "NoIcons", this value MUST be 0 and this record does not specify a filter and MUST be ignored. If iconSet is not "NoIcons", this value MUST be greater than or equal to 0. If the icon set specified by iconSet has three icons, this value MUST be less than or equal to 2. If the icon set specified by iconSet has four icons, this value MUST be less than or equal to 3. If the icon set specified by iconSet has five icons, this value MUST be less than or equal to 4.

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

1675

1676

1677

1678

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

1678.1.1CT_Filter

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

Referenced by: filter

This complex type specifies a filter criterion. Rows that contain a cell within the filter range that have value val will not be hidden by this filter criterion. Rows that do not contain such a cell inside a filters element ([ISO/IEC29500-1:2012] section 18.3.2.8) will be hidden.

Attributes:

val: An ST_Xstring ([ISO/IEC29500-1:2012] section 22.9.2.19) attribute that specifies the value to be used as a filter criterion. The length of this value MUST be less than 65536 characters.

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

1679

1680

1681

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

1681.1.1CT_CustomFilters

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

Referenced by: customFilters

This complex type specifies custom filter criteria. Rows that contain a cell within the filter range such that the value does not meet the custom filter criteria will be hidden.

Child Elements:

customFilter: A CT_CustomFilter element that specifies a custom filter criterion.

Attributes:

and: A Boolean ([XMLSCHEMA2] section 3.2.2) attribute that specifies the relationship between custom filter criterion. This attribute only applies when there are two criteria.

Value	Meaning
"false"	The two criteria are related by an OR relationship. That is, for a cell value to meet the custom filter criteria, at least one criterion specified by the customFilter child elements MUST be met.
"true"	The two criteria are related by an AND relationship. That is, for a cell value to meet the custom filter criteria, both criteria specified by the customFilter child elements MUST be met.

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

1682

1683

1684

1685

1686

1687

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

1687.1.1CT_CustomFilter

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

Referenced by: CT_CustomFilters

This complex type specifies a custom filter criterion.

Attributes:

operator: An ST_FilterOperator ([ISO/IEC29500-1:2012] section 18.18.31) attribute that specifies the operator of the custom filter criterion.

val: An ST_Xstring ([ISO/IEC29500-1:2012] section 22.9.2.19) attribute that specifies the value to be used as a custom filter criterion. The length of this value MUST be less than 65536 characters.

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

1688

1689

1690

1691

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

1691.1.1CT_SortCondition

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

Referenced by: sortCondition

A complex type that specifies a sort condition to apply to a range.

Attributes:

descending: A Boolean ([XMLSCHEMA2] section 3.2.2) attribute that specifies the direction of the sort.

Value	Meaning
"false"	If sortBy is "value", sort in ascending order. If sortBy is "cellColor" or "fontColor", cells in which the cell color or cell font color specified by dxfId occurs are ordered at the top of the range. If sortBy is "icon", cells in which the icon specified by iconSet and iconId occurs are ordered at the top of the range.
"true"	If sortBy is "value", sort in descending order. If sortBy is "cellColor" or "fontColor", cells in which the cell color or cell font color specified by dxfId occurs are ordered at the bottom of the range. If sortBy is "icon", cells in which the icon specified by iconSet and iconId occurs are ordered at the bottom of the range.

sortBy: An ST_SortBy ([ISO/IEC29500-1:2012] section 18.18.72) attribute that specifies how the cells in a range are sorted.

ref: An ST_Ref ([ISO/IEC29500-1:2012] section 18.18.62) attribute that specifies the row or column to which this sort condition applies. This value MUST be contained within the ref in the sortState ([ISO/IEC29500-1:2012] section 18.3.1.92) element that precedes this element. If the sortState.columnSort attribute that precedes this element is "false", this value specifies the column to which this sort condition applies and there MUST be only a single column specified by ref. If the sortState.columnSort attribute that precedes this element is "true", this value specifies the row to which this sort condition applies and there MUST be only a single row specified by ref.

customList: An ST_Xstring ([ISO/IEC29500-1:2012] section 22.9.2.19) attribute that specifies a comma-delimited list of strings that specifies a custom sort order. The order of strings in the list specifies the sort order. When a cell value matches a string in the list, it is sorted ahead of the cell values that match a later string in the list, and so on for each cell in the range. MUST be ignored if sortBy is not equal to "value".

dxfId: An ST_DxfId ([ISO/IEC29500-1:2012] section 18.18.25) attribute that specifies the format identifier when sortBy equals "cellColor" or sortBy equals "fontColor". MUST NOT be present if sortBy equals "icon" or "value".

iconSet: An ST_IconSetType attribute that specifies the icon set when sortBy equals "icon". The absence of this attribute means no icon. MUST NOT be present if sortBy is not equal to "icon".

iconId: An unsignedInt ([XMLSCHEMA2] section 3.3.22) attribute that specifies the zero-based index of an icon in an icon set. If the icon set specified by iconSet has three icons, this value MUST be less than or equal to 2. If the icon set specified by iconSet has four icons, this value MUST be less than or equal to 3. If the icon set specified by iconSet has five icons, this value MUST be less than or equal to 4. The absence of this attribute means no icon. MUST NOT be present if sortBy is not equal to "icon".

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

1692

1693

1694

1695

1696

1697

1698

1699

1700

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