Interface: ISheetClipboardHook
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:84
ClipboardHook
could:
- Before copy/cut/paste, decide whether to execute the command and prepare caches if necessary.
- When copying, decide what content could be written into clipboard.
- When pasting, get access to the clipboard content and append mutations to the paste command.
Properties
Methods
getFilteredOutRows()?
optional getFilteredOutRows(range): number[]
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:182
The callback would be called before the clipboard service decides what region need to be copied from or pasted to. It would jump over these filtered rows when copying or pasting.
Parameters
Parameter | Type |
---|---|
range | IRange |
Returns
number
[]
onAfterCopy()?
optional onAfterCopy(): void
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:124
Would be called after copy content has been written into clipboard. Features could do some cleaning up jobs here.
Returns
void
onAfterPaste()?
optional onAfterPaste(success): void
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:176
Parameters
Parameter | Type |
---|---|
success | boolean |
Returns
void
onBeforeCopy()?
optional onBeforeCopy(
unitId,
subUnitId,
range): void
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:94
The callback would be called after the clipboard service has decided what region need to be copied. Features could use this hook to build copying cache or any other pre-copy jobs.
Parameters
Parameter | Type |
---|---|
unitId | string |
subUnitId | string |
range | IRange |
Returns
void
onBeforePaste()?
optional onBeforePaste(pasteTo): boolean
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:137
The callback would be called after the clipboard service has decided what region need to be pasted. Features could use this hook to build copying cache or any other pre-copy jobs.
Parameters
Parameter | Type |
---|---|
pasteTo | ISheetDiscreteRangeLocation |
Returns
boolean
if it block copying it should return false
onCopyCellContent()?
optional onCopyCellContent(row, col): string
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:101
Parameters
Parameter | Type |
---|---|
row | number |
col | number |
Returns
string
content
onCopyCellStyle()?
optional onCopyCellStyle(
row,
col,
rowSpan?,
colSpan?): null | IClipboardPropertyItem
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:109
Properties that would be appended to the td element.
Parameters
Parameter | Type | Description |
---|---|---|
row | number | row of the the copied cell |
col | number | col of the the copied cell |
rowSpan ? | number | - |
colSpan ? | number | - |
Returns
null
| IClipboardPropertyItem
Deprecated
should be merged with onCopyCellContent
to onCopyCell
onCopyColumn()?
optional onCopyColumn(col): null | IClipboardPropertyItem
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:119
Properties that would be appended to the col element.
Parameters
Parameter | Type | Description |
---|---|---|
col | number | each col of the copied range |
Returns
null
| IClipboardPropertyItem
onCopyRow()?
optional onCopyRow(row): null | IClipboardPropertyItem
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:114
Properties that would be appended to the tr element.
Parameters
Parameter | Type | Description |
---|---|---|
row | number | each row of the the copied range |
Returns
null
| IClipboardPropertyItem
onPasteCells()?
optional onPasteCells(
pasteFrom,
pasteTo,
data,
payload): {
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:143
Parameters
Parameter | Type |
---|---|
pasteFrom | null | ISheetDiscreteRangeLocation |
pasteTo | ISheetDiscreteRangeLocation |
data | ObjectMatrix <ICellDataWithSpanInfo > |
payload | ICopyPastePayload |
Returns
{
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Name | Type | Defined in |
---|---|---|
redos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:150 |
undos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:149 |
onPasteColumns()?
optional onPasteColumns(
pasteTo,
colProperties,
payload): {
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:160
Parameters
Parameter | Type |
---|---|
pasteTo | ISheetDiscreteRangeLocation |
colProperties | IClipboardPropertyItem [] |
payload | ICopyPastePayload |
Returns
{
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Name | Type | Defined in |
---|---|---|
redos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:166 |
undos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:165 |
onPastePlainText()?
optional onPastePlainText(
pasteTo,
text,
payload): {
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:168
Parameters
Parameter | Type |
---|---|
pasteTo | ISheetDiscreteRangeLocation |
text | string |
payload | ICopyPastePayload |
Returns
{
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Name | Type | Defined in |
---|---|---|
redos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:174 |
undos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:173 |
onPasteRows()?
optional onPasteRows(
pasteTo,
rowProperties,
payload): {
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Defined in: submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:152
Parameters
Parameter | Type |
---|---|
pasteTo | ISheetDiscreteRangeLocation |
rowProperties | IClipboardPropertyItem [] |
payload | ICopyPastePayload |
Returns
{
redos: IMutationInfo[];
undos: IMutationInfo[];
}
Name | Type | Defined in |
---|---|---|
redos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:158 |
undos | IMutationInfo [] | submodules/univer/packages/sheets-ui/src/services/clipboard/type.ts:157 |