DragType Property, SftTree Object
Defines the method that determines when a drag & drop operation starts.
Syntax
Get
Put
object
A SftTree object.
Type
Defines the method that determines when a drag & drop operation starts. When a drag & drop operation starts, the OLEStartDrag, DragStarting or AutoDragging events are generated, based on the DragMethod property settings.
| Type | Value | Description |
|---|
| dragSftTreeNext | 0 | The drag & drop operation can start from a cell and is initiated once the mouse cursor leaves the current item. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again. |
| dragSftTreeBmpNext | 1 | The drag & drop operation can start from a , an or a cell and is initiated once the mouse cursor leaves the current item. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again. |
| dragSftTreePix | 2 | The drag & drop operation can start from a cell and is initiated once the mouse cursor is moved by a certain pixel distance. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again. |
| dragSftTreeBmpPix | 3 | The drag & drop operation can start from a , an or a cell and is initiated once the mouse cursor is moved by a certain pixel distance. Before an item can be dragged, it has to be selected using the keyboard or the mouse button and the mouse button has to be released, then a drag & drop operation can be started by pressing the mouse button again. |
| dragSftTreeNextImm | 4 | The drag & drop operation can start from a cell and is initiated once the mouse cursor leaves the current item. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property). |
| dragSftTreeBmpNextImm | 5 | The drag & drop operation can start from a , an or a cell and is initiated once the mouse cursor leaves the current item. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property). |
| dragSftTreePixImm | 6 | The drag & drop operation can start from a cell and is initiated once the mouse cursor is moved by a certain pixel distance. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property). |
| dragSftTreeBmpPixImm | 7 | The drag & drop operation can start from a , an or a cell and is initiated once the mouse cursor is moved by a certain pixel distance. An item can be dragged as it is selected in a single or multiple selection tree control (see Items.MultiSelect property). |
Comments
The DragType property defines the method that determines when a drag & drop operation starts.
The DragType property determines when the OLEStartDrag, DragStarting or AutoDragging event is generated to notify the application that a drag & drop operation has been initiated by the user.
A drag & drop operation always starts at the current location described by the Items.Current property. It is the application's responsibility to visually implement the drag & drop operation unless OLE drag & drop is used.
Depending on the Type selected, dragging can start on the cell only or also on the and the .
With some Type values, a drag & drop operation starts once the user moves the mouse cursor by a certain pixel distance. The pixel distance used is retrieved by using the Windows API GetSystemMetrics(SM_CX/Y/DRAG).
See Also SftTree Object | Object Hierarchy
On
Off