DragEvent Class

Provide information about a drag event, which enables the drag-and-drop client (the receiving window) to track the progress of the mouse during the drag operation and to identify the files that the user can drop.

Inheritance Hierarchy

Object
Event
DragEvent

Namespace: VO
Assembly: VOGUIClasses (in VOGUIClasses.dll) Version: 2.19

Syntax

Copy

 CLASS DragEvent INHERIT Event

public class DragEvent : Event

Request Example View Source

The DragEvent type exposes the following members.

Constructors

	Name	Description
	DragEvent	Construct an event.

Top

Properties

	Name	Description
	Control	A control object returning the control whenever a drop-and-drag event has occurred inside a control with WS_EX_ACCEPTFILES set. If WS_EX_ACCEPTFILES is TRUE, the control accepts files and triggers a call to its parent Drop() method.
	FileCount	A numeric value representing the number of files in the drag-and-drop load that generated this drag event.
	Handle	The pointer to the window where the event occurred (Inherited from Event.)
	Message	A dword representing the Windows API message associated with the given event. (Inherited from Event.)
	Origin	A point representing the location of the mouse in canvas coordinates at the time this drag event was generated.
	Window	An object indicating the window or control in which the event occurred. This is helpful, for example, for distinguishing between similar menu events coming from the same context menu attached to different controls. (Inherited from Event.)

Top

Methods

	Name	Description
	FileName	Return the name of a specified file in the drag-and-drop load that generated this drag event.

Top

Fields

	Name	Description
	hWnd	(Inherited from Event.)
	lParam	(Inherited from Event.)
	oWindow	(Inherited from Event.)
	uMsg	(Inherited from Event.)
	wParam	(Inherited from Event.)

Top

Remarks

Drag-and-drop is a GUI convention for moving objects from one place to another. In Windows, the convention only supports files. A drag event occurs when the user drags a group of previously selected files to a new location. Drag events occur in the target window where the selection will be dropped (not in the window where the selection was made).

Tip
Drag events do not occur in the drag-and-drop server (the source of the files)—only in the drag-and-drop client (the target). When the drag enters the client area, the drag event goes to the DragDropClient:DragOver() method of the client. If the drag leaves the client without dropping its files, and the drag-and-drop client has returned TRUE to the DragOver() method, a generic event goes to DragDropClient:DragLeave(). It is then no longer relevant or correct for the application to query the event if it is leaving the client. If the user drops the files, the drag event goes to DragDropClient:Drop().

Tip

Drag events do not occur in the drag-and-drop server (the source of the files)—only in the drag-and-drop client (the target). When the drag enters the client area, the drag event goes to the DragDropClient:DragOver() method of the client. If the drag leaves the client without dropping its files, and the drag-and-drop client has returned TRUE to the DragOver() method, a generic event goes to DragDropClient:DragLeave(). It is then no longer relevant or correct for the application to query the event if it is leaving the client. If the user drops the files, the drag event goes to DragDropClient:Drop().

Reference

VO Namespace