DnDAccept (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drag and drop functions

WLanguage procedure

DnDAccept

Presentation

Example

Variables

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.

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

Example

// Procedure called by the dndDrop event
PROCÉDURE 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:
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:).
dndMove Moving data is allowed in the target control. The move cursor will be displayed during the move:
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: 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 through programming in the code corresponding to the "Drop" (to do so, test _DND.Action and _DND.SourceControl).

Component: wd270obj.dll