A sheet in a Mirosoft Excel workbook that displays a single chart.

Hierarchy

Hierarchy

Implements

  • IWorksheetShapeOwner
  • ISheetBackground

Constructors

Properties

$type: Type
$t: Type
nextHashCode: number

Accessors

  • get displayOptions(): ChartsheetDisplayOptions
  • Gets the object which controls the display of the chartsheet.

    The display options include any settings which affect the display of the chartsheet when viewed in Microsoft Excel. These settings will not affect the printed chartsheet or the data stored in the chartsheet.

    The object which controls the display of the chartsheet.

    See

    CustomView.getSheetDisplayOptions

    Returns ChartsheetDisplayOptions

  • get hasProtectionPassword(): boolean
  • Returns a boolean indicating if the Sheet has been protected with a password.

    When protecting a Sheet, a password is optional. The HasProtectionPassword will return true if the Sheet is currently protected (see isProtected) and a password was specified when it was protected.

    See

    Returns boolean

  • get isProtected(): boolean
  • Returns a boolean indicating if the Worksheet has been protected.

    The IsProtected property will return true if the Worksheet is currently protected. When a Worksheet is protected only unprotected cells may be edited. In addition, other operations may be limited based on the properties of the WorksheetProtection which may be accessed using the Protection property.

    See

    Returns boolean

  • get name(): string
  • Gets or sets the sheet name.

    The sheet name is case-insensitively unique in the workbook.

    The sheet name is shown in the tab for the worksheet. In addition, the worksheet name can be used by formulas from other worksheets to refer to cells in this worksheet.

    The sheet name.

    Throws

    ArgumentNullException The value assigned is null or empty.

    Throws

    ArgumentException The value assigned contains the invalid characters: ':', '', '/', '?', '*', '[', or ']'.

    Throws

    ArgumentException The value assigned exceeds 31 characters in length.

    Throws

    ArgumentException The value assigned is being used as the name of another sheet (sheet names are case-insensitively compared).

    Returns string

  • set name(a: string): void
  • Parameters

    • a: string

    Returns void

  • get selected(): boolean
  • Gets the value which indicates whether this worksheet is selected.

    If the worksheet has been removed from its parent Workbook.worksheets collection, this will always return False.

    The value which indicates whether this worksheet is selected.

    See

    Returns boolean

  • get sheetIndex(): number
  • Gets the zero-based index of this sheet in its parent Workbook.sheets collection.

    Negative one indicates the sheet has been removed from its parent collection.

    The zero-based index of this sheet in its parent Sheets collection.

    See

    Returns number

  • get tabColorInfo(): WorkbookColorInfo
  • Gets or sets the WorkbookColorInfo to use for the associated sheet's tab in the tab bar of Microsoft Excel.

    If the tab bar is not visible, this color will not be seen.

    The WorkbookColorInfo to use for the associated sheet's tab in the tab bar of Microsoft Excel.

    See

    WindowOptions.tabBarVisible

    Returns WorkbookColorInfo

  • set tabColorInfo(a: WorkbookColorInfo): void
  • Parameters

    Returns void

  • get type(): SheetType
  • Returns Chartsheet

    Returns SheetType

  • get workbook(): Workbook
  • Gets the workbook that owns the worksheet. The Workbook that owns the worksheet.

    Returns Workbook

Methods

  • Parameters

    • other: any

    Returns boolean

  • Returns number

  • Moves the sheet to a new position in the owning workbook's collections of sheets.

    Throws

    InvalidOperationException The sheet has previously been removed from its workbook.

    Throws

    ArgumentOutOfRangeException 'index' is less than 0 or greater than or equal to the number of sheets in the owning workbook.

    See

    Parameters

    • index: number

      The new 0-based index to where the sheet should be moved.

    Returns void

  • Protects the chartsheet without a password.

    When a Chartsheet is protected without a password, the end user may unprotect the Chartsheet in Excel without having to supply a password. To programatically unprotect a Chartsheet, one may use the Unprotect() method.

    The optional parameters are used to update the property values of the ChartsheetProtection instance from this Worksheet's protection property. If the parameter is null, the current value of the associated property will be retained; otherwise the property will be updated with the specified value. For example, if the ChartsheetProtection.allowEditObjects is currently true and the 'allowEditObjects' is null, then the property will continue to be true but if the 'allowEditObjects' is false the ChartsheetProtection.allowEditObjects will be changed to false.

    Note: If IsProtected is already true, the method will be ignored.

    See

    Parameters

    • Optional allowEditObjects: boolean

      Optional boolean indicating the new value for the ChartsheetProtection.allowEditObjects.

    • Optional allowEditContents: boolean

      Optional boolean indicating the new value for the ChartsheetProtection.AllowEditScenarios. @see@see@see protection

    Returns void

  • Parameters

    • item1: any
    • item2: any

    Returns number

  • Parameters

    • item1: any
    • item2: any

    Returns number

  • Parameters

    • item1: any
    • item2: any

    Returns boolean

  • Parameters

    • a: any
    • b: any

    Returns boolean

  • Parameters

    • obj: any

    Returns any[]

  • Parameters

    • obj: any

    Returns any[]

  • Parameters

    • obj: any

    Returns number

  • Parameters

    • a: any
    • b: any

    Returns boolean

  • Returns void