version 2003
PA_AllowDrop (params; allow)
Parameter | Type | Description | |
params | PA_PluginParameters | Parameters received in PluginMain | |
allow | char | 1 = Allow the drop, 0 = Disallow it |
Description
The routine PA_AllowDrop tells 4th Dimension if the area accepts the object being dragged over it. Set allow to 1 if the area accepts the object, otherwise, set it to 0.
The area usually calls PA_GetDragAndDropInfo to look at the object being dragged before using this routine, especially to see if the area can accept it.
This routine can be called only at eAE_AllowDrop event. If it is not called for this event, it does nothing and PA_GetLastError returns eER_BadEventCall.
NOTE
The routines "Drag and Drop" are internal to 4th Dimension. The developer cannot use them with other applications.
Example
See the sample in Drag and drop with a plug-in area and the example in PA_GetDragAndDropInfo.
See Also
Drag and drop with a plugin area, PA_CustomizeDragOver, PA_GetDragAndDropInfo, PA_GetDragPositions.
Error Handling
Use PA_GetLastError to see if an error occurred (eER_BadEventCall)