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