Drag Start - GRID SENDMSG() Function 25

Syntax

TF$=SENDMSG(sysgui,id,25,cursor,string${,context{,ERR=lineref}})

Description

For BBj-specific documentation, seeDrag Start - GRID SENDMSG() Function 25 BBj.

This function starts a drag-and-drop operation and specifies the data to be dropped. It does not return a value until the operation is finished.

Parameter	Description
sysgui	SYSGUI channel.
id	Grid control ID.
25	Number of this SENDMSG() function.
cursor	Cursor parameter, which can be one of the following: -1 The cursor set with SENDMSG() Function 78 0 Arrow and small hourglass 1 Arrow 2 Crosshair 3 Text I-beam 4 Reserved for a future version 5 Slashed circle 6 Reserved for a future version 7 Four-pointed arrow 8 Double-pointed arrow pointing northeast and southwest 9 Double-pointed arrow pointing up and down 10 Double-pointed arrow pointing northwest and southeast 11 Double-pointed arrow pointing left and right 12 Arrow pointing up 13 Hourglass
string $	String to be used in the drag-and-drop operation.

If the cursor parameter is -1, the default cursor will be used for the drag-and-drop operation. Otherwise, an index to a cursor resource may be entered.

Once the operation is completed, a DRAGDROP Notify event (Notify code 4) is sent. This event reports the location where the drop occurred. The return value is a one-byte string that indicates the success or failure of an operation; $01$ indicates success, $00$ indicates failure.

See Also

Set Drag Accept - Grid SENDMSG() Function 33.