[Table of Contents] [docx version]

SpreadsheetML Reference Material - Table of Contents

customSheetView (Custom Sheet View)

This collection stores information pertaining to one custom sheet view definition. A custom view is a collection of settings defining a particular view of the sheet. These views may be selected by the user for quick access to predefined views of the sheet.

[Example: This example indicates that there is both a horizontal and vertical split in the sheet view, and that the top left cell of the bottom right pane is F7. Page margin, print options, page setup, and header / footer information is also stored with this view.

<customSheetView guid="{F3A061A9-D5FD-4F9C-A7CD-483AD476BA25}"
sizeWithWindow="0">
<pane xSplit="5" ySplit="6" topLeftCell="F7"/>

<selection/>

<pageMargins left="0.7" right="0.7" top="0.75" bottom="0.75" header="0.3"
footer="0.3"/>

<printOptions gridLinesSet="0"/>

<pageSetup paperSize="0" scale="0" orientation="portrait" printDriver="0"
horizontalDpi="0" verticalDpi="0" copies="0"/>

<headerFooter/>

</customSheetView>

end example]

Parent Elements

customSheetViews3.3.1.25)

 

Child Elements

Subclause

autoFilter (AutoFilter Settings)

§3.3.1.1

colBreaks (Vertical Page Breaks)

§3.3.1.13

extLst (Future Feature Data Storage Area)

§3.2.10

headerFooter (Header Footer Settings)

§3.3.1.43

pageMargins (Page Margins)

§3.3.1.60

pageSetup (Page Setup Settings)

§3.3.1.61

pane (View Pane)

§3.3.1.64

printOptions (Print Options)

§3.3.1.68

rowBreaks (Horizontal Page Breaks (Row))

§3.3.1.72

selection (Selection)

§3.3.1.75

 

Attributes

Description

colorId (Color Id)

Index to the color value for the text in row/column headings and gridlines for this custom view. This is an 'index color value' (ICV) rather than rgb value.

 

The possible values for this attribute are defined by the XML Schema unsignedInt datatype.

filter (Filtered List)

Flag indicating whether the view contains a filtered range.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

filterUnique (Filter)

Indicates whether an advanced filter has been applied, and the option to filter out duplicate records from the data list has been selected, in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

fitToPage (Fit To Page)

Flag indicating whether this view should be fit to page when printing this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

guid (GUID)

Unique identifier of this custom view. This is used to ensure uniqueness. It is generated when the view is created. Must correspond to a customWorkbookView guid value in the workbook Start Part.

 

The possible values for this attribute are defined by the ST_Guid simple type (§3.18.41).

hiddenColumns (Hidden Columns)

Flag indicating that there is one or more hidden column(s) in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

hiddenRows (Hidden Rows)

Flag indicating that there is one or more hidden row(s) in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

outlineSymbols (Show Outline Symbols)

Flag indicating whether outline symbols are displayed in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

printArea (Print Area Defined)

Flag indicating whether a print area is defined as part of this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

scale (Print Scale)

Print scaling for this custom view. Valid values range from 10 to 400.

 

For example:

 

10 - 10%

20 - 20%

100 - 100%

400 - 400%

 

The possible values for this attribute are defined by the XML Schema unsignedInt datatype.

showAutoFilter (Show AutoFitler Drop Down Controls)

Flag indicating whether the autofilter dropdown buttons are visible in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

showFormulas (Show Formulas)

Flag indicating whether formulas are shown in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

showGridLines (Show Grid Lines)

Flag indicating whether gridlines are shown in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

showPageBreaks (Show Page Breaks)

Flag indicating whether page breaks are shown in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

showRowCol (Show Headers)

Flag indicating whether row and column headers are shown in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

showRuler (Show Ruler)

Flag indicating whether to show the ruler in this custom view. Only applicable if this Custom View is in Page Layout View.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

state (Visible State)

Visibility state for this custom view.

 

The possible values for this attribute are defined by the ST_SheetState simple type (§3.18.70).

topLeftCell (Top Left Visible Cell)

Location of the top left visible cell in the bottom right pane in this custom view (when in Left-to-Right mode).

 

The possible values for this attribute are defined by the ST_CellRef simple type (§3.18.8).

view (View Type)

Indicates the view type for this Custom View

 

The possible values for this attribute are defined by the ST_SheetViewType simple type (§3.18.71).

zeroValues (Show Zero Values)

Flag indicating whether the window should display 0 (zero) values in this custom view.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_CustomSheetView">

   <sequence>

   <element name="pane" type="CT_Pane" minOccurs="0" maxOccurs="1"/>

   <element name="selection" type="CT_Selection" minOccurs="0" maxOccurs="1"/>

   <element name="rowBreaks" type="CT_PageBreak" minOccurs="0" maxOccurs="1"/>

   <element name="colBreaks" type="CT_PageBreak" minOccurs="0" maxOccurs="1"/>

   <element name="pageMargins" type="CT_PageMargins" minOccurs="0" maxOccurs="1"/>

   <element name="printOptions" type="CT_PrintOptions" minOccurs="0" maxOccurs="1"/>

   <element name="pageSetup" type="CT_PageSetup" minOccurs="0" maxOccurs="1"/>

   <element name="headerFooter" type="CT_HeaderFooter" minOccurs="0" maxOccurs="1"/>

   <element name="autoFilter" type="CT_AutoFilter" minOccurs="0" maxOccurs="1"/>

   <element name="extLst" minOccurs="0" type="CT_ExtensionList"/>

   </sequence>

   <attribute name="guid" type="ST_Guid" use="required"/>

   <attribute name="scale" type="xsd:unsignedInt" default="100"/>

   <attribute name="colorId" type="xsd:unsignedInt" default="64"/>

   <attribute name="showPageBreaks" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="showFormulas" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="showGridLines" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="showRowCol" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="outlineSymbols" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="zeroValues" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="fitToPage" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="printArea" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="filter" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="showAutoFilter" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="hiddenRows" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="hiddenColumns" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="state" type="ST_SheetState" default="visible"/>

   <attribute name="filterUnique" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="view" type="ST_SheetViewType" default="normal"/>

   <attribute name="showRuler" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="topLeftCell" type="ST_CellRef" use="optional"/>

</complexType>