DnDAccept (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Variables

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DnDAccept (Function)

In french: DnDAccepte

Indicates the action accepted by the target of Drag/Drop and manages the mouse cursor during Drag/Drop.

Note: DnDAccept must be used during the call to the dndDrop event (DnDEvent).

Versions 17 and later

This function is now available in Browser code.

New in version 17

This function is now available in Browser code.

Example

See additional examples

// Procedure called by the dndDrop event
PROCEDURE OnDrop()
// Only the move is allowed (not the copy)
DnDAccept(dndMove)

Syntax

DnDAccept(<Authorized action>)

<Authorized action>: Constant

Action allowed on the target control:
dndCopy Copying data is allowed in the target control. The copy cursor will be displayed during the copy:
dndMove Moving data is allowed in the target control. The move cursor will be displayed during the move:
dndDefault Copying data or moving data is allowed in the target control.
The default cursor will be displayed during the move:
(to perform a copy, keep the Ctrl key down while moving the data. The default cursor will be: ).
dndNone No action is allowed in the target control. The "forbidden" cursor will be displayed during the copy/move:

Remarks

Variables

The following variables can be used:

Variable name	Description

_DND.Action	Action specified in DnDAccept. The possible values are as follows: dndCopy, dndMove and dndNone. This variable is not filled at the beginning of Drag and Drop in a source control (dndBeginDrag constant) or when exiting from a target control (dndDragLeave constant).
_DND.TargetControl	Name of target control. This variable is not filled at the beginning of Drag and Drop in a source control (dndBeginDrag constant) or when exiting from a target control (dndDragLeave constant).
_DND.SourceControl	Name of source control.
_DND.CtrlDown	Status of Ctrl key: True: the Ctrl key is pressed. False: the Ctrl key is not pressed. This variable is not filled at the beginning of Drag and Drop in a source control (dndBeginDrag constant) or when exiting from a target control (dndDragLeave constant).
_DND.SourceWin	Name of source window. This variable is not filled when exiting from a target control (dndDragLeave constant).
_DND.MouseXPos	Horizontal position (X) of mouse cursor in relation to the control handled during the event. This variable is not filled when exiting from a target control (dndDragLeave constant).
_DND.MouseYPos	Vertical position (Y) of mouse cursor in relation to the control handled during the event. This variable is not filled when exiting from a target control (dndDragLeave constant).

The _DND.SourceControl and _DND.SourceWin variables return an empty string ("") when the Drag and Drop comes from an application other than the current application.

During a Drag/Drop, the data found in the source must be deleted by programming in the code corresponding to the "Drop" (to do so, test _DND.Action and _DND.SourceControl).

Component : wd240obj.dll