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

Class: SheetSelectionRenderService

This services controls rendering of normal selections in a render unit. The normal selections would also be used by Auto Fill and Copy features.

Extends

• BaseSelectionRenderService

Implements

• IRenderModule

Constructors

new SheetSelectionRenderService()

new SheetSelectionRenderService(
   _context, 
   injector, 
   themeService, 
   shortcutService, 
   selectionManagerService, 
   sheetSkeletonManagerService, 
   _logService, 
   _commandService, 
   _contextService): SheetSelectionRenderService

Parameters

Returns

SheetSelectionRenderService

Overrides

BaseSelectionRenderService.constructor

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/selection-render.service.ts:43

Properties

Accessors

selectionMoving

Get Signature

get selectionMoving(): boolean

Returns

boolean

Inherited from

BaseSelectionRenderService.selectionMoving

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:171

Methods

_addEndingListeners()

protected _addEndingListeners(): void

Returns

void

Inherited from

BaseSelectionRenderService._addEndingListeners

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:735

_addSelectionControlByModelData()

protected _addSelectionControlByModelData(selectionWithStyle): SelectionShape

Add a selection in spreadsheet, create a new SelectionControl and then update this control by range derives from selection.

Parameters

Returns

SelectionShape

Inherited from

BaseSelectionRenderService._addSelectionControlByModelData

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:333

_changeRuntime()

protected _changeRuntime(
   skeleton, 
   scene, 
   viewport?): void

Parameters

Returns

void

Inherited from

BaseSelectionRenderService._changeRuntime

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:293

_checkClearPreviousControls()

protected _checkClearPreviousControls(evt): void

Parameters

Returns

void

Inherited from

BaseSelectionRenderService._checkClearPreviousControls

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:831

_clearAllSelectionControls()

protected _clearAllSelectionControls(): void

Returns

void

Inherited from

BaseSelectionRenderService._clearAllSelectionControls

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:343

_clearUpdatingListeners()

protected _clearUpdatingListeners(): void

Returns

void

Inherited from

BaseSelectionRenderService._clearUpdatingListeners

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:720

_getFreeze()

protected _getFreeze(): Nullable<IFreeze>

Returns

Nullable<IFreeze>

Inherited from

BaseSelectionRenderService._getFreeze

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:352

_getSelectionWithCoordByOffset()

protected _getSelectionWithCoordByOffset(
   offsetX, 
   offsetY, 
   scaleX, 
   scaleY, 
scrollXY): Nullable<ISelectionWithCoord>

Get visible selection range & coord by offset on viewport. Nearly same as skeleton.getCellWithCoordByOffset Returning selection is only one cell. primary and range are same cell.

visible selection range means getCellWithCoordByOffset needs first matched row/col in rowHeightAccumulation & colWidthAccumulation. Original name: _getCellRangeByCursorPosition

Parameters

Returns

Nullable<ISelectionWithCoord>

selection range with coord.

Inherited from

BaseSelectionRenderService._getSelectionWithCoordByOffset

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:765

_getViewportByCell()

protected _getViewportByCell(row?, column?): Nullable<Viewport>

Parameters

Returns

Nullable<Viewport>

Inherited from

BaseSelectionRenderService._getViewportByCell

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:357

_makeSelectionByTwoCells()

protected _makeSelectionByTwoCells(
   currentCell, 
   startSelectionRange, 
   skeleton, 
   rangeType, 
   activeControl): void

Parameters

Returns

void

Inherited from

BaseSelectionRenderService._makeSelectionByTwoCells

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:844

_movingHandler()

protected _movingHandler(
   offsetX, 
   offsetY, 
   activeSelectionControl, 
   rangeType): void

When mousedown and mouseup need to go to the coordination and undo stack, when mousemove does not need to go to the coordination and undo stack

Parameters

Returns

void

Inherited from

BaseSelectionRenderService._movingHandler

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:646

_onPointerDown()

protected _onPointerDown(
   evt, 
   _zIndex, 
   rangeType, 
   viewport, 
   scrollTimerType): void

Handle pointer down event, bind pointermove & pointerup handler. then trigger selectionMoveStart$.

Parameters

Returns

void

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/selection-render.service.ts:257

_reset()

protected _reset(): void

Clear existed selections by workbookSelections.selectionMoveEnd$

Returns

void

Inherited from

BaseSelectionRenderService._reset

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:422

_resetSelectionStyle()

protected _resetSelectionStyle(): void

Reset this._selectionStyle to default normal selection style

Returns

void

Inherited from

BaseSelectionRenderService._resetSelectionStyle

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:217

_setSelectionStyle()

protected _setSelectionStyle(style): void

Parameters

Returns

void

Inherited from

BaseSelectionRenderService._setSelectionStyle

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:210

_setupPointerMoveListener()

protected _setupPointerMoveListener(
   viewportMain, 
   activeSelectionControl, 
   rangeType, 
   scrollTimerType, 
   moveStartPosX, 
   moveStartPosY): void

Init pointer move listener in each pointer down, unbind in each pointer up. Both cell selections and row-column selections are supported by this method.

Parameters

Returns

void

Inherited from

BaseSelectionRenderService._setupPointerMoveListener

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:446

attachPrimaryWithCoord()

attachPrimaryWithCoord(primary): ICellWithCoord

Parameters

Returns

ICellWithCoord

Deprecated

Use the function attachPrimaryWithCoord instead`.

Inherited from

BaseSelectionRenderService.attachPrimaryWithCoord

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:622

attachSelectionWithCoord()

attachSelectionWithCoord(selectionWithStyle): ISelectionWithCoord

Parameters

Returns

ISelectionWithCoord

Deprecated

Use the function attachSelectionWithCoord instead`.

Inherited from

BaseSelectionRenderService.attachSelectionWithCoord

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:617

dispose()

dispose(): void

Returns

void

Implementation of

IRenderModule.dispose

Inherited from

BaseSelectionRenderService.dispose

Defined in

submodules/univer/packages/core/src/shared/lifecycle.ts:106

disposeWithMe()

disposeWithMe(disposable): IDisposable

Parameters

Returns

IDisposable

Inherited from

BaseSelectionRenderService.disposeWithMe

Defined in

submodules/univer/packages/core/src/shared/lifecycle.ts:96

endSelection()

endSelection(): void

Returns

void

Inherited from

BaseSelectionRenderService.endSelection

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:410

ensureNotDisposed()

protected ensureNotDisposed(): void

Returns

void

Inherited from

BaseSelectionRenderService.ensureNotDisposed

Defined in

submodules/univer/packages/core/src/shared/lifecycle.ts:100

getActiveRange()

getActiveRange(): Nullable<IRange>

Returns the selected range in the active sheet, or null if there is no active range. If multiple ranges are selected this method returns only the last selected range.

Returns

Nullable<IRange>

Inherited from

BaseSelectionRenderService.getActiveRange

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:386

getActiveSelectionControl()

getActiveSelectionControl<T>(): Nullable<T>

get active(actually last) selection control

Type Parameters

Returns

Nullable<T>

T extends SelectionControl

Inherited from

BaseSelectionRenderService.getActiveSelectionControl

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:403

getCellWithCoordByOffset()

getCellWithCoordByOffset(x, y): ICellWithCoord

Parameters

Returns

ICellWithCoord

Inherited from

BaseSelectionRenderService.getCellWithCoordByOffset

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:633

getSelectionCellByPosition()

getSelectionCellByPosition(x, y): ICellWithCoord

Parameters

Returns

ICellWithCoord

Deprecated

Please use getCellWithCoordByOffset instead.

Inherited from

BaseSelectionRenderService.getSelectionCellByPosition

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:629

getSelectionControls()

getSelectionControls(): SelectionShape[]

Returns

SelectionShape[]

TODO

lumixraku DO NOT expose private props.

Inherited from

BaseSelectionRenderService.getSelectionControls

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:325

getSelectionDataWithStyle()

getSelectionDataWithStyle(): ISelectionWithCoord[]

Generate selectionData from this._selectionControls.model .

Returns

ISelectionWithCoord[]

{range, primary, style}[]

Inherited from

BaseSelectionRenderService.getSelectionDataWithStyle

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:311

getSkeleton()

getSkeleton(): SpreadsheetSkeleton

Returns

SpreadsheetSkeleton

Inherited from

BaseSelectionRenderService.getSkeleton

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:303

getViewPort()

getViewPort(): Viewport

Returns

Viewport

Deprecated

This should not be provided by the selection render service.

Inherited from

BaseSelectionRenderService.getViewPort

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:222

newSelectionControl()

newSelectionControl(
   scene, 
   skeleton, 
   selection): SelectionShape

Parameters

Returns

SelectionShape

Inherited from

BaseSelectionRenderService.newSelectionControl

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:230

refreshSelectionMoveEnd()

refreshSelectionMoveEnd(): void

Returns

void

Inherited from

BaseSelectionRenderService.refreshSelectionMoveEnd

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:289

refreshSelectionMoveStart()

refreshSelectionMoveStart(): void

Returns

void

Inherited from

BaseSelectionRenderService.refreshSelectionMoveStart

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:285

resetSelectionsByModelData()

resetSelectionsByModelData(selectionsWithStyleList): void

Update the corresponding selectionControl based on selectionsData. selectionData[i] syncs selectionControls[i]

Parameters

Returns

void

Inherited from

BaseSelectionRenderService.resetSelectionsByModelData

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:262

setSingleSelectionEnabled()

setSingleSelectionEnabled(enabled): void

Parameters

Returns

void

Inherited from

BaseSelectionRenderService.setSingleSelectionEnabled

Defined in

submodules/univer/packages/sheets-ui/src/services/selection/base-selection-render.service.ts:226