|
|
|
|
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
)