Form Data Model: _getDragData

Form Data Model: _getDragData

Exports the data from the model

Syntax
Details

Syntax

CALL SEND (model-id, '_getDragData', rep, oper, data, srow, scol, erow, ecol);

Argument Type Description

rep
C specifies the representation selected for the drop

oper
C specifies the operation selected for the drop

data
N returns the identifier of an SCL list that contains the data defined by the representation

srow
N specifies the row coordinates list of the starting row of the drag

scol
N specifies the column coordinates list of the starting column of the drag

erow
N specifies the row coordinates list of the ending row of the drag

ecol
N specifies the column coordinates list of the ending column of the drag

Argument	Type	Description
rep	C	specifies the representation selected for the drop
oper	C	specifies the operation selected for the drop
data	N	returns the identifier of an SCL list that contains the data defined by the representation
srow	N	specifies the row coordinates list of the starting row of the drag
scol	N	specifies the column coordinates list of the starting column of the drag
erow	N	specifies the row coordinates list of the ending row of the drag
ecol	N	specifies the column coordinates list of the ending column of the drag

Details

The _getDragData method is called automatically after a drag object from the attached viewer has been dropped and the viewer does not recognize the rep passed to it. The _getDragData method runs before the _validateDropData method runs. This method provides the model with a way to export data in a format that depends on the passed representation to the drop site object. The data list passed to _getDragData is a global list to facilitate passing data between tasks; any lists added to data should be global lists. The data list will automatically be deleted for you.

The srow, scol, erow, and ecol parameters are passed as coordinates of the location of where the drag started. If you are using a viewer supplied with SAS/AF software, such as the data table or data form, these coordinates are automatically translated for you by the attached viewer into coordinates that make sense for the attached viewer. For example, when the attached viewer is a data table, a table editor, or a subclass of the table editor, the coordinates are translated into cell coordinates of the selected area that was dragged. If the attached viewer is a data form, a form editor, or a subclass of the form editor, srow and erow have the same value and scol and ecol have the same value. The value of these pairs of parameters (srow and scol, and erow and ecol) indicates the pixel offset measuring from the top left corner of the form editor to where the drag started.

Note: If you are using a user-defined viewer, you must translate the pixel offset into units that make sense for your viewer. [cautionend]

For general information about drag and drop operations, see SAS/AF online help.

Chapter Contents
Previous
Next
Top of Page