Returns or sets a value that determines whether manual or automatic drag mode is used for a drag-and-drop operation.
Syntax
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. |
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. |
Remarks
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.