Событие DragOver

Имеет место, когда элемент управления, перетаскиваемый с помощью мыши, накр вает объект назначения.

Применение

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

Синтаксис

PROCEDURE Object.DragOver
LPARAMETERS [nIndex,] oSource, nXCoord, nYCoord, nState

Параметры

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

Visual FoxPro передает событию DragOver четыре или пять параметров в следующем порядке:

nIndex

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

oSource

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

nXCoord, nYCoord

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

nState

Содержит число, обозначающее переходное состояние перемещаемого элемента управ ения относительно объекта назначения:

Установка	Описание
0	Enter (вошел). Элемент управления перемещается в пределах объекта назначения.
1	Leave (вышел). Элемент управления выводится за пределы объекта назначения.
2	Over (внутри). Элемент управления передвинулся из одной позиции в объекте наз ачения на другую.

С помощью параметра nState можно определять действия, которые должны выполняться в ключевые переходные моменты. Например, в состоянии nState = 0 (Enter) можно выделить подсветкой предполагаемый объект назначения, а в состоянии nState = 1 (Leave) восстановить его прежний вид.

Когда объект получает событие DragOver в состоянии nState = 0 (Enter), происходит следующее:

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

Если исходный элемент управления не остается на месте допустимого объекта наз ачения, инициируется другое событие DragOver в состоянии nState = 1 (Leave).

Комментарии

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

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