Событие DragDrop

Имеет место при завершении операции перетаскивания с помощью мыши.

Применение

CheckBox, ComboBox, CommandButton, CommandGroup, Объект Container, Объект Control, EditBox, Form, Grid, Image, Label, Line, ListBox, Связанный элемент управления OLE, Элемент управления OLE - контейнер, OptionButton, OptionGroup, Page, PageFrame, Shape, Spinner, TextBox, ToolBar

Синтаксис

PROCEDURE Object.DragDrop
LPARAMETERS [nIndex,] oSource, nXCoord, nYCoord

Параметры

Необходимо включить в процедуру для данного события оператор LPARAMETERS или PARAMETERS и задать имя для каждого параметра. Visual FoxPro передает событию DragDrop три или четыре параметра в следующем порядке:

nIndex

Однозначно идентифицирует элемент управления, если он принадлежит массиву э ементов управления.

oSource

Указывает перетаскиваемый элемент управления. С помощью этого параметра можно ссылаться на свойства и методы элемента управления.

nXCoord, nYCoord

Содержит текущие горизонтальную (nXCoord) и вертикальную (nYCoord) координаты указателя мыши в форме или элементе управления, к которым произво ится перетаскивание. Эти координаты всегда выражаются относительно координат ой системы объекта назначения, с использованием единицы измерения, определяемой свойством ScaleMode.

Комментарии

Операция перетаскивания с помощью мыши завершается, когда данный элемент управ ения наложится на другой элемент управления или другую форму и пользователь отпустит кнопку мыши или когда для данного элемента управления вызывается метод Drag с аргументом nAction, имеющим значение 2 (Drop).

С помощью события DragDrop можно контролировать, что будет происходить после завершения операции перетаскивания. Например, можно перетащить исходный элемент управления на новую позицию или скопировать из одного места в другое.

Замечание Событие DragDrop подразумевает участие двух объектов перетаскиваемого элемента управления и объекта назначения. Событие DragDrop и ициируется для объекта назначения, а не для перетаскиваемого элемента управле ия.

Используя свойство DragMode и метод Drag, можно задавать тот или иной способ и ициирования операции перетаскивания. После того как эта операция началась, вы можете обрабатывать события, предшествующие событию DragDrop, с помощью события DragOver.