Show / Hide Table of Contents

Class ExcelWorksheetView

Represents the different view states of the worksheet

Inheritance
System.Object
XmlHelper
ExcelWorksheetView
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: OfficeOpenXml
Assembly: EPPlus.dll
Syntax
public class ExcelWorksheetView : XmlHelper

Properties

ActiveCell

The active cell. Single cell address.
This cell must be inside the selected range. If not, the selected range is set to the active cell address

Declaration
public string ActiveCell { get; set; }
Property Value
Type Description
System.String

BottomLeftPane

The bottom left pane. This property returns null if the pane does not exist in the Panes array.

Declaration
public ExcelWorksheetView.ExcelWorksheetPanes BottomLeftPane { get; }
Property Value
Type Description
ExcelWorksheetView.ExcelWorksheetPanes

BottomRightPane

The bottom right pane. This property returns null if the pane does not exist in the Panes array.

Declaration
public ExcelWorksheetView.ExcelWorksheetPanes BottomRightPane { get; }
Property Value
Type Description
ExcelWorksheetView.ExcelWorksheetPanes

PageBreakView

Sets the view mode of the worksheet to pagebreak

Declaration
public bool PageBreakView { get; set; }
Property Value
Type Description
System.Boolean

PageLayoutView

Sets the view mode of the worksheet to pagelayout

Declaration
public bool PageLayoutView { get; set; }
Property Value
Type Description
System.Boolean

Panes

Reference to the panes

Declaration
public ExcelWorksheetView.ExcelWorksheetPanes[] Panes { get; }
Property Value
Type Description
ExcelWorksheetView.ExcelWorksheetPanes[]

PaneSettings

Contains settings for the active pane

Declaration
public ExcelWorksheetView.ExcelWorksheetViewPaneSettings PaneSettings { get; }
Property Value
Type Description
ExcelWorksheetView.ExcelWorksheetViewPaneSettings

RightToLeft

If the sheet is in 'right to left' display mode. Column A is on the far right and column B to the left of A. Text is also 'right to left'.

Declaration
public bool RightToLeft { get; set; }
Property Value
Type Description
System.Boolean

SelectedRange

Selected Cells in the worksheet. Used in combination with ActiveCell. If the active cell is not inside the selected range, the active cell will be set to the first cell in the selected range. If the selected range has multiple adresses, these are separated with space. If the active cell is not within the first address in this list, the attribute ActiveCellId must be set (not supported, so it must be set via the XML).

Declaration
public string SelectedRange { get; set; }
Property Value
Type Description
System.String

SheetViewElement

Returns a reference to the sheetView element

Declaration
protected XmlElement SheetViewElement { get; }
Property Value
Type Description
System.Xml.XmlElement

ShowGridLines

Show gridlines in the worksheet

Declaration
public bool ShowGridLines { get; set; }
Property Value
Type Description
System.Boolean

ShowHeaders

Show the Column/Row headers (containg column letters and row numbers)

Declaration
public bool ShowHeaders { get; set; }
Property Value
Type Description
System.Boolean

TabSelected

If the worksheet is selected within the workbook. NOTE: Setter clears other selected tabs.

Declaration
public bool TabSelected { get; set; }
Property Value
Type Description
System.Boolean

TabSelectedMulti

If the worksheet is selected within the workbook. NOTE: Setter keeps other selected tabs.

Declaration
public bool TabSelectedMulti { get; set; }
Property Value
Type Description
System.Boolean

TopLeftCell

The Top-Left Cell visible. Single cell address. Empty string or null is the same as A1.

Declaration
public string TopLeftCell { get; set; }
Property Value
Type Description
System.String

TopLeftPane

The top left pane or the top pane if the sheet is horizontaly split. This property returns null if the pane does not exist in the Panes array.

Declaration
public ExcelWorksheetView.ExcelWorksheetPanes TopLeftPane { get; }
Property Value
Type Description
ExcelWorksheetView.ExcelWorksheetPanes

TopRightPane

The top right pane. This property returns null if the pane does not exist in the Panes array.

Declaration
public ExcelWorksheetView.ExcelWorksheetPanes TopRightPane { get; }
Property Value
Type Description
ExcelWorksheetView.ExcelWorksheetPanes

ZoomScale

Window zoom magnification for current view representing percent values.

Declaration
public int ZoomScale { get; set; }
Property Value
Type Description
System.Int32

Methods

FreezePanes(Int32, Int32)

Freeze the columns/rows to left and above the cell

Declaration
public void FreezePanes(int Row, int Column)
Parameters
Type Name Description
System.Int32 Row
System.Int32 Column

SetTabSelected(Boolean, Boolean)

Sets whether the worksheet is selected within the workbook.

Declaration
public void SetTabSelected(bool isSelected = true, bool allowMultiple = false)
Parameters
Type Name Description
System.Boolean isSelected

Whether the tab is selected, defaults to true.

System.Boolean allowMultiple

Whether to allow multiple active tabs, defaults to false.

SplitPanes(Int32, Int32)

Split the window at the supplied row/column. The split is performed using the current width/height of the visible rows and columns, so any changes to column width or row heights after the split will not effect the split position. To remove split call this method with zero as value of both paramerters or use UnFreezePanes()

Declaration
public void SplitPanes(int rowsTop, int columnsLeft)
Parameters
Type Name Description
System.Int32 rowsTop

Splits the panes at the coordinate after this visible row. Zero mean no split on row level

System.Int32 columnsLeft

Splits the panes at the coordinate after this visible column. Zero means no split on column level.

SplitPanesPixels(Int32, Int32)

Split panes at the position in pixels from the top-left corner.

Declaration
public void SplitPanesPixels(int pixelsY, int pixelsX)
Parameters
Type Name Description
System.Int32 pixelsY

Vertical pixels

System.Int32 pixelsX

Horizontal pixels

UnFreezePanes()

Unlock all rows and columns to scroll freely

Declaration
public void UnFreezePanes()
In This Article
Back to top Generated by DocFX