Edit

Share via


Excel.Interfaces.WorksheetLoadOptions interface

An Excel worksheet is a grid of cells. It can contain data, tables, charts, etc. To learn more about the worksheet object model, read Work with worksheets using the Excel JavaScript API.

Remarks

[ API set: ExcelApi 1.1 ]

Properties

$all

Specifying $all for the load options loads all the scalar properties (such as Range.address) but not the navigational properties (such as Range.format.fill.color).

autoFilter

Represents the AutoFilter object of the worksheet.

charts

Returns a collection of charts that are part of the worksheet.

enableCalculation

Determines if Excel should recalculate the worksheet when necessary. True if Excel recalculates the worksheet when necessary. False if Excel doesn't recalculate the sheet.

id

Returns a value that uniquely identifies the worksheet in a given workbook. The value of the identifier remains the same even when the worksheet is renamed or moved.

name

The display name of the worksheet. The name must be fewer than 32 characters.

pageLayout

Gets the PageLayout object of the worksheet.

position

The zero-based position of the worksheet within the workbook.

protection

Returns the sheet protection object for a worksheet.

showGridlines

Specifies if gridlines are visible to the user.

showHeadings

Specifies if headings are visible to the user.

standardHeight

Returns the standard (default) height of all the rows in the worksheet, in points.

standardWidth

Specifies the standard (default) width of all the columns in the worksheet. One unit of column width is equal to the width of one character in the Normal style. For proportional fonts, the width of the character 0 (zero) is used.

tabColor

The tab color of the worksheet. When retrieving the tab color, if the worksheet is invisible, the value will be null. If the worksheet is visible but the tab color is set to auto, an empty string will be returned. Otherwise, the property will be set to a color, in the form #RRGGBB (e.g., "FFA500"). When setting the color, use an empty-string to set an "auto" color, or a real color otherwise.

tabId

Returns a value representing this worksheet that can be read by Open Office XML. This is an integer value, which is different from worksheet.id (which returns a globally unique identifier) and worksheet.name (which returns a value such as "Sheet1").

tables

Collection of tables that are part of the worksheet.

visibility

The visibility of the worksheet.

Property Details

$all

Specifying $all for the load options loads all the scalar properties (such as Range.address) but not the navigational properties (such as Range.format.fill.color).

TypeScript
$all?: boolean;

Property Value

boolean

autoFilter

Represents the AutoFilter object of the worksheet.

TypeScript
autoFilter?: Excel.Interfaces.AutoFilterLoadOptions;

Property Value

Remarks

[ API set: ExcelApi 1.9 ]

charts

Returns a collection of charts that are part of the worksheet.

TypeScript
charts?: Excel.Interfaces.ChartCollectionLoadOptions;

Property Value

Remarks

[ API set: ExcelApi 1.1 ]

enableCalculation

Determines if Excel should recalculate the worksheet when necessary. True if Excel recalculates the worksheet when necessary. False if Excel doesn't recalculate the sheet.

TypeScript
enableCalculation?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.9 ]

id

Returns a value that uniquely identifies the worksheet in a given workbook. The value of the identifier remains the same even when the worksheet is renamed or moved.

TypeScript
id?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.1 ]

name

The display name of the worksheet. The name must be fewer than 32 characters.

TypeScript
name?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.1 ]

pageLayout

Gets the PageLayout object of the worksheet.

TypeScript
pageLayout?: Excel.Interfaces.PageLayoutLoadOptions;

Property Value

Remarks

[ API set: ExcelApi 1.9 ]

position

The zero-based position of the worksheet within the workbook.

TypeScript
position?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.1 ]

protection

Returns the sheet protection object for a worksheet.

TypeScript
protection?: Excel.Interfaces.WorksheetProtectionLoadOptions;

Property Value

Remarks

[ API set: ExcelApi 1.2 ]

showGridlines

Specifies if gridlines are visible to the user.

TypeScript
showGridlines?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.8 ]

showHeadings

Specifies if headings are visible to the user.

TypeScript
showHeadings?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.8 ]

standardHeight

Returns the standard (default) height of all the rows in the worksheet, in points.

TypeScript
standardHeight?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.7 ]

standardWidth

Specifies the standard (default) width of all the columns in the worksheet. One unit of column width is equal to the width of one character in the Normal style. For proportional fonts, the width of the character 0 (zero) is used.

TypeScript
standardWidth?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.7 ]

tabColor

The tab color of the worksheet. When retrieving the tab color, if the worksheet is invisible, the value will be null. If the worksheet is visible but the tab color is set to auto, an empty string will be returned. Otherwise, the property will be set to a color, in the form #RRGGBB (e.g., "FFA500"). When setting the color, use an empty-string to set an "auto" color, or a real color otherwise.

TypeScript
tabColor?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.7 ]

tabId

Returns a value representing this worksheet that can be read by Open Office XML. This is an integer value, which is different from worksheet.id (which returns a globally unique identifier) and worksheet.name (which returns a value such as "Sheet1").

TypeScript
tabId?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.14 ]

tables

Collection of tables that are part of the worksheet.

TypeScript
tables?: Excel.Interfaces.TableCollectionLoadOptions;

Property Value

Remarks

[ API set: ExcelApi 1.1 ]

visibility

The visibility of the worksheet.

TypeScript
visibility?: boolean;

Property Value

boolean

Remarks

[ API set: ExcelApi 1.1 for reading visibility; 1.2 for setting it. ]