Form Data Model: _validateDropData

Form Data Model: _validateDropData

Allows the model to validate the drag operation's data

Syntax
Details

Syntax

CALL SEND (model-id, '_validateDropData', rep, oper, data, row, column, return-code);

Argument Type Description

rep C specifies the representation selected for the drop

oper C specifies the operation selected for the drop

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

row
N specifies an SCL list identifier that contains the row coordinates of the row on which the drop occurred

column N specifies an SCL list identifier that contains the column coordinates of the column on which the drop occurred

return-code C specifies the return code:

_blank the data were successfully validated

'C' cancel the drag operation

Argument	Type	Description
rep	C	specifies the representation selected for the drop
oper	C	specifies the operation selected for the drop
data	N	specifies the identifier of an SCL list that contains the data defined by the representation
row	N	specifies an SCL list identifier that contains the row coordinates of the row on which the drop occurred
column	N	specifies an SCL list identifier that contains the column coordinates of the column on which the drop occurred
return-code	C	specifies the return code:
		_blank	the data were successfully validated
		'C'	cancel the drag operation

Details

The _validateDropData method is called when a drag object has been dropped on the attached viewer and the viewer does not recognize the rep passed to it. This method is passed the data returned from the _getDragData method, which was called on the drag object. This method is called to give the model a chance to validate the data and possibly cancel the drag operation if the data is not valid.

The location of the drop has been translated by the attached viewer into coordinates that make sense for that viewer. For example, when the attached viewer is a table editor or a subclass of the table editor, the location is translated into cell coordinates.

No new FRAME entries or applications can be started from this method, and the execution of the SCL code for this method cannot be followed through the SCL Debugger.

Note:The _validateDropData method is followed by the _drop method, so it is advisable to test the representation and the action before responding to the drop operation.

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

Chapter Contents
Previous
Next
Top of Page