Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter EighteenDataView Integration (continued)

on_edit_copy

Overview

The on_edit_copy event handler is called when the user requests to copy data. This event is tied to the EDIT_COPY menu function.

Syntax/Parameters

Syntax

int on_edit_copy ( int row, int column ) { ... }

Parameters

row

An int that specifies the row of the cell that has focus.

column

An int that specifies the column of the cell that has focus.

Return Value

Returns an int. If the hook processes the action, return ERROR_EXIT to stop any further processing. If the event is not canceled, the return code is passed back to Data View for processing.

Remarks

This hook allows for the serving script to usurp control of the copy function and either preprocess or process and exit.

The position parameters provided are the caret position. Depending on the select mode of Data View, more cells could be selected. In which case, the select range must be retrieved to apply further processing. It is also possible for the caret to not be in the select range.

Note that the default operation is to copy all cell properties including style and attributes. The copied data is presented to the clipboard in a number of formats.

This hook is not called on edit cut.

Related Events

Page revised 2024-04-22