@univerjs/sheets v0.5.0-beta.1Docs


Class: FWorkbook

FBase is a base class for all facade classes. It provides a way to extend classes with static and instance methods. The _initialize as a special method that will be called after the constructor. You should never call it directly.

Extends

Extended by

Constructors

new FWorkbook()

new FWorkbook(
   _workbook, 
   _injector, 
   _resourceLoaderService, 
   _selectionManagerService, 
   _univerInstanceService, 
   _commandService, 
   _permissionService, 
   _logService): FWorkbook

Parameters

ParameterType
_workbookWorkbook
_injectorInjector
_resourceLoaderServiceIResourceLoaderService
_selectionManagerServiceSheetsSelectionsService
_univerInstanceServiceIUniverInstanceService
_commandServiceICommandService
_permissionServiceIPermissionService
_logServiceILogService

Returns

FWorkbook

Overrides

FBase.constructor

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:27

Properties

PropertyModifierTypeDefined in
_commandServicereadonlyICommandServicesubmodules/univer/packages/sheets/src/facade/f-workbook.ts:33
_injectorreadonlyInjectorsubmodules/univer/packages/sheets/src/facade/f-workbook.ts:29
_logServicereadonlyILogServicesubmodules/univer/packages/sheets/src/facade/f-workbook.ts:35
_permissionServicereadonlyIPermissionServicesubmodules/univer/packages/sheets/src/facade/f-workbook.ts:34
_resourceLoaderServicereadonlyIResourceLoaderServicesubmodules/univer/packages/sheets/src/facade/f-workbook.ts:30
_selectionManagerServicereadonlySheetsSelectionsServicesubmodules/univer/packages/sheets/src/facade/f-workbook.ts:31
_univerInstanceServicereadonlyIUniverInstanceServicesubmodules/univer/packages/sheets/src/facade/f-workbook.ts:32
_workbookreadonlyWorkbooksubmodules/univer/packages/sheets/src/facade/f-workbook.ts:28
idreadonlystringsubmodules/univer/packages/sheets/src/facade/f-workbook.ts:25

Methods

_initialize()

_initialize(): void

Returns

void

Inherited from

FBase._initialize

Defined in

submodules/univer/packages/core/src/facade/f-base.ts:33


create()

create(
   name, 
   rows, 
   column): FWorksheet

Create a new worksheet and returns a handle to it.

Parameters

ParameterTypeDescription
namestringName of the new sheet
rowsnumberHow may rows would the new sheet have
columnnumberHow many columns would the new sheet have

Returns

FWorksheet

The new created sheet

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:94


deleteSheet()

deleteSheet(sheet): void

Deletes the specified worksheet.

Parameters

ParameterTypeDescription
sheetFWorksheetThe worksheet to delete.

Returns

void

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:189


getActiveRange()

getActiveRange(): null | FRange

Returns the selected range in the active sheet, or null if there is no active range.

Returns

null | FRange

the active range

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:303


getActiveSheet()

getActiveSheet(): FWorksheet

Get the active sheet of the workbook.

Returns

FWorksheet

The active sheet of the workbook

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:72


getId()

getId(): string

Returns

string

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:42


getName()

getName(): string

Returns

string

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:46


getSheetByName()

getSheetByName(name): null | FWorksheet

Get a worksheet by sheet name.

Parameters

ParameterTypeDescription
namestringThe name of the sheet to get.

Returns

null | FWorksheet

The worksheet with given sheet name

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:139


getSheetBySheetId()

getSheetBySheetId(sheetId): null | FWorksheet

Get a worksheet by sheet id.

Parameters

ParameterTypeDescription
sheetIdstringThe id of the sheet to get.

Returns

null | FWorksheet

The worksheet with given sheet id

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:125


getSheets()

getSheets(): FWorksheet[]

Gets all the worksheets in this workbook

Returns

FWorksheet[]

An array of all the worksheets in the workbook

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:81


getSnapshot()

getSnapshot(): IWorkbookData

Returns

IWorkbookData

{IWorkbookData}

Deprecated

use ‘save’ instead.

Memberof

FWorkbook

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:63


insertSheet()

insertSheet(): FWorksheet

Inserts a new worksheet into the workbook. Using a default sheet name. The new sheet becomes the active sheet

Returns

FWorksheet

The new sheet

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:167


onBeforeCommandExecute()

onBeforeCommandExecute(callback): IDisposable

Register a callback that will be triggered before invoking a command targeting the Univer sheet.

Parameters

ParameterTypeDescription
callbackCommandListenerthe callback.

Returns

IDisposable

A function to dispose the listening.

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:215


onCommandExecuted()

onCommandExecuted(callback): IDisposable

Register a callback that will be triggered when a command is invoked targeting the Univer sheet.

Parameters

ParameterTypeDescription
callbackCommandListenerthe callback.

Returns

IDisposable

A function to dispose the listening.

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:230


onSelectionChange()

onSelectionChange(callback): IDisposable

Parameters

ParameterType
callback(selections) => void

Returns

IDisposable

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:240


redo()

redo(): Promise<boolean>

Returns

Promise<boolean>

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:205


save()

save(): IWorkbookData

save workbook snapshot data, including conditional formatting, data validation, and other plugin data.

Returns

IWorkbookData

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:53


setActiveRange()

setActiveRange(range): void

Sets the active selection region for this sheet.

Parameters

ParameterTypeDescription
rangeFRangeThe range to set as the active selection.

Returns

void

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:274


setActiveSheet()

setActiveSheet(sheet): FWorksheet

Sets the given worksheet to be the active worksheet in the workbook.

Parameters

ParameterTypeDescription
sheetFWorksheetThe worksheet to set as the active worksheet.

Returns

FWorksheet

The active worksheet

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:153


setEditable()

setEditable(value): void

Used to modify the editing permissions of the workbook. When the value is false, editing is not allowed.

Parameters

ParameterTypeDescription
valuebooleaneditable value want to set

Returns

void

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:261


undo()

undo(): Promise<boolean>

Returns

Promise<boolean>

Defined in

submodules/univer/packages/sheets/src/facade/f-workbook.ts:200


extend()

static extend(source): void

Parameters

ParameterType
sourceany

Returns

void

Inherited from

FBase.extend

Defined in

submodules/univer/packages/core/src/facade/f-base.ts:35