OLEDragDrop Event

Object Reference> True DBGrid Events> OLEDragDrop Event

OLEDragDrop Event

The OLEDragDrop event occurs when a grid control is the target component of a drag/drop operation and its OLEDropMode is set to 1 - Manual.

Syntax

TDBGrid_OLEDragDrop (Data As TrueDBGrid80.DataObject, Effect As Long, Button As Integer, Shift As Integer, X As Single, Y As Single)

Arguments

Data is a DataObject object containing formats that the source will provide and possibly the data for those formats. If no data is contained in the DataObject, it is provided when the control calls the GetData method. The SetData and Clear methods cannot be used here.

Effect is a long integer set by the source object identifying the action that has been performed, thus allowing the source to take appropriate action if the component was moved (such as the source deleting data if it is moved from one component to another). The possible values of Effectare as follows:

0 - vbDropEffectNone	Drop target cannot accept the data or the drop operation was canceled.
1 - vbDropEffectCopy	Drop results in a copy of data from the source to the target. The original data is unaltered by the drag operation.
2 - vbDropEffectMove	Drop results in a link to the original data being created between drag source and drop target.

Button is an integer that corresponds to the state of the mouse buttons in which a bit is set if the button is down. The Button argument is a bit field with bits corresponding to the left button (bit 0), right button (bit 1), and middle button (bit 2). These bits correspond to the values 1, 2, and 4, respectively. The Button argument indicates the complete state of the mouse buttons; some, all, or none of these three bits can be set, indicating that some, all, or none of the buttons are pressed.

Shift is an integer that corresponds to the state of the Shift, Ctrl, and Alt keys. A bit is set if the key is down. The Shift argument is a bit field with the least-significant bits corresponding to the Shift key (bit 0), the Ctrl key (bit 1), and the Alt key (bit 2). These bits correspond to the values 1, 2, and 4, respectively. Some, all, or none of the bits can be set, indicating that some, all, or none of the keys are pressed. For example, if both Ctrl and Alt are pressed, the value of Shift is 6.

X and Y are single-precision numbers that specify the current location of the mouse pointer. They are always expressed in terms of the coordinate system of the grid's container.

Remarks

This event informs the grid that a drop action was either performed or canceled by the source control, the location of the drop, and the mouse button and shift key states.