[Table of Contents] [docx version]

SpreadsheetML Reference Material - Table of Contents

sheetView (Worksheet View)

A single sheet view definition. When more than 1 sheet view is defined in the file, it means that when opening the workbook, each sheet view corresponds to a separate window within the spreadsheet application, where each window is showing the particular sheet. containing the same workbookViewId value, the last sheetView definition is loaded, and the others are discarded. When multiple windows are viewing the same sheet, multiple sheetView elements (with corresponding workbookView entries) are saved.

Parent Elements

sheetViews3.3.1.85)

 

Child Elements

Subclause

extLst (Future Feature Data Storage Area)

§3.2.10

pane (View Pane)

§3.3.1.64

pivotSelection (PivotTable Selection)

§3.3.1.67

selection (Selection)

§3.3.1.75

 

Attributes

Description

colorId (Color Id)

Index to the color value for row/column text headings and gridlines. 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.

defaultGridColor (Default Grid Color)

Flag indicating that the consuming application should use the default grid lines color (system dependent). Overrides any color specified in colorId.

 

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

rightToLeft (Right To Left)

Flag indicating whether the sheet is in 'right to left' display mode. When in this mode, Column A is on the far right, Column B ;is one column left of Column A, and so on. Also, information in cells is displayed in the Right to Left format.

 

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

showFormulas (Show Formulas)

Flag indicating whether this sheet should display formulas.

 

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

showGridLines (Show Grid Lines)

Flag indicating whether this sheet should display gridlines.

 

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

showOutlineSymbols (Show Outline Symbols)

Flag indicating whether the sheet has outline symbols visible. This flag shall always override SheetPr element's outlinePr child element whose attribute is named showOutlineSymbols when there is a conflict.

 

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

showRowColHeaders (Show Headers)

Flag indicating whether the sheet should display row and column headings.

 

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

showRuler (Show Ruler)

Show the ruler in Page Layout View.

 

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

showWhiteSpace (Show White Space)

Flag indicating whether page layout view shall display margins. False means do not display left, right, top (header), and bottom (footer) margins (even when there is data in the header or footer).

 

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

showZeros (Show Zero Values)

Flag indicating whether the window should show 0 (zero) in cells containing zero value. When false, cells with zero value appear blank instead of showing the number zero.

 

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

tabSelected (Sheet Tab Selected)

Flag indicating whether this sheet is selected. When only 1 sheet is selected and active, this value should be in synch with the activeTab value. In case of a conflict, the Start Part setting wins and sets the active sheet tab.

 

Note: multiple sheets can be selected, but only one sheet can be active at one time.

 

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

topLeftCell (Top Left Visible Cell)

Location of the top left visible cell Location of the top left visible cell in the bottom right pane (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 view type.

 

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

windowProtection (Window Protection)

Flag indicating whether the panes in the window are locked due to workbook protection. This is an option when the workbook structure is protected.

 

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

workbookViewId (Workbook View Index)

Zero-based index of this workbook view, pointing to a workbookView element in the bookViews collection.

 

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

zoomScale (Zoom Scale)

Window zoom magnification for current view representing percent values. Valid values range from 10 to 400. Horizontal & Vertical scale together.

 

For example:

 

10 - 10%

20 - 20%

100 - 100%

400 - 400%

 

Current view can be Normal, Page Layout, or Page Break Preview.

 

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

zoomScaleNormal (Zoom Scale Normal View)

Zoom magnification to use when in normal view, representing percent values. Valid values range from 10 to 400. Horizontal & Vertical scale together.

 

For example:

 

10 - 10%

20 - 20%

100 - 100%

400 - 400%

 

Applies for worksheet sheet type only; zero implies the automatic setting.

 

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

zoomScalePageLayoutView (Zoom Scale Page Layout View)

Zoom magnification to use when in page layout view, representing percent values. Valid values range from 10 to 400. Horizontal & Vertical scale together.

 

For example:

 

10 - 10%

20 - 20%

100 - 100%

400 - 400%

 

Applies for worksheet sheet type only; zero implies the automatic setting.

 

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

zoomScaleSheetLayoutView (Zoom Scale Page Break Preview)

Zoom magnification to use when in page break preview, representing percent values. Valid values range from 10 to 400. Horizontal & Vertical scale together.

 

For example:

 

10 - 10%

20 - 20%

100 - 100%

400 - 400%

 

Applies for worksheet only; zero implies the automatic setting.

 

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

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

<complexType name="CT_SheetView">

   <sequence>

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

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

   <element name="pivotSelection" type="CT_PivotSelection" minOccurs="0" maxOccurs="4"/>

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

   </sequence>

   <attribute name="windowProtection" 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="showRowColHeaders" type="xsd:boolean" use="optional" default="true"/>

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

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

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

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

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

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

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

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

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

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

   <attribute name="zoomScale" type="xsd:unsignedInt" use="optional" default="100"/>

   <attribute name="zoomScaleNormal" type="xsd:unsignedInt" use="optional" default="0"/>

   <attribute name="zoomScaleSheetLayoutView" type="xsd:unsignedInt" use="optional" default="0"/>

   <attribute name="zoomScalePageLayoutView" type="xsd:unsignedInt" use="optional" default="0"/>

   <attribute name="workbookViewId" type="xsd:unsignedInt" use="required"/>

</complexType>