104
DROP..ON Directive
Drag and Drop
Format
1. Define Drag & Drop: DROP source_ctl_id ON dest_ctl_id RETURN new_ctl_id
2. Remove Logic: DROP source_ctl_id ON dest_ctl_id REMOVE
3. Temporarily Disable: DROP source_ctl_id ON dest_ctl_id DISABLE
4. Re-Enable Drag & Drop: DROP source_ctl_id ON dest_ctl_id ENABLE
Where:
dest_ctl_id
Unique numeric identifier for the destination control.
new_ctl_id
The CTL signal that is generated when the drop occurs on the
destination object. Avoid integers that conflict with keyboard definitions
(e.g., 4 cancels CTL=4 for the F4 key) or special negative CTL values set
by the system. See Negative CTL Definitions, p.822.
source_ctl_id
Unique numeric identifier for the source control.
Description
The Drag and Drop feature allows for copying or moving of information from one
object to another object. The drop event is triggered when a mouse is used to select
information from the source object, drag the selection to another object, and deposit
the information at the new location. The application is responsible for adding the
information to the destination object and removing it from the source object.
The available Drag From or source controls are multi-lines and various types of list
boxes, drop boxes, and grids.
The available Drop On or destination controls are buttons, check boxes, drop boxes,
grids, multi-lines, list boxes, radio buttons, tristate boxes. The highlighting of items
on which the drop will occur is not supported in simple or formatted list boxes;
however, this is supported in list view, report view, and tree view objects.
Note: When using the DISABLE syntax, the cursor will still change indicating that the
drop is valid, however the signal indicating the drop took place is not generated.