version 2003
PA_GetDragPositions (params; rect; x; y)
Parameter | Type | Description | |
params | PA_PluginParameters | Parameters received in PluginMain | |
rect | PA_Rect* | Rectangle of the object | |
x | short* | Global Horizontal mouse position | |
y | short* | Global Vertical mouse position |
Description
The routine PA_GetDragPositions returns information on the dragging position of the object being drag/dropped. It can only be called when PA_GetAreaEvent returns eAE_Drag.
The coordinates are global to the screen (MacOS) or the MDI Window (Windows)
The "Droppable" checkbox of the object properties of the area must be set in order to make the area droppable.
If the current area event is not eAE_Drag, the routine does nothing (it leaves *rect, *x, and *y unchanged), and PA_GetLastError returns eER_BadEventCall.
The area receives information on the object itself if the event is eAE_AllowDrop, by calling PA_GetDragAndDropInfo.
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 plugin area.
See Also
Drag and drop with a plugin area, PA_AllowDrop, PA_CustomizeDragOver, PA_GetDragAndDropInfo.
Error Handling
Use PA_GetLastError to see if an error occurred (eER_BadEventCall).