Visual Basic Reference

Visual Studio 6.0

DragMode Property

See Also    Example    Applies To

Returns or sets a value that determines whether manual or automatic drag mode is used for a drag-and-drop operation.


object.DragMode [= number]

The DragMode property syntax has these parts:

Part Description
Object An object expression that evaluates to an object in the Applies To list.
Number An integer that specifies the drag mode, as described in Settings.


The settings for number are:

Constant Setting Description
VbManual 0 (Default) Manual requires using the Drag method to initiate a drag-and-drop operation on the source control.
VbAutomatic 1 Automatic clicking the source control automatically initiates a drag-and-drop operation. OLE container controls are automatically dragged only when they don't have the focus.


When DragMode is set to 1 (Automatic), the control doesn't respond as usual to mouse events. Use the 0 (Manual) setting to determine when a drag-and-drop operation begins or ends; you can use this setting to initiate a drag-and-drop operation in response to a keyboard or menu command or to enable a source control to recognize a MouseDown event prior to a drag-and-drop operation.

Clicking while the mouse pointer is over a target object or form during a drag-and-drop operation generates a DragDrop event for the target object. This ends the drag-and-drop operation. A drag-and-drop operation may also generate a DragOver event.

Note   While a control is being dragged, it can't recognize other user-initiated mouse or keyboard events (KeyDown, KeyPress or KeyUp, MouseDown, MouseMove, or MouseUp). However, the control can receive events initiated by code or by a DDE link.