Происходит тогда, когда элемент управления перетаскивается над целевым объектом.
PROCEDURE Object.DragOver LPARAMETERS oSource, nXCoord, nYCoord, nState |
Параметры
Вы должны включить в процедуру события команду LPARAMETERS или PARAMETERS и указать имя для каждого параметра; в противном случае будет сгенерирована ошибка. Visual FoxPro посылает параметры событию DragOver в приведенном ниже порядке:
- 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), если перетаскиваемый элемент управления бросается на действительном целевом объекте.
Примечание
Применяется к: CheckBox | ComboBox | CommandButton | CommandGroup | Control Object | EditBox | Form | Grid | Image | Label | Line | ListBox | OLE Bound Control | OLE Container Control | OptionButton | OptionGroup | Page | PageFrame | Shape | Spinner | TextBox | ToolBar
Объект под иконкой перетаскиваемого объекта представляет собой целевой объект, отвечающий на событие DragOver. Вы можете использовать это событие для отслеживания перемещений указателя мыши, когда он входит в область целевого объекта, выходит из нее или находится непосредственно над целевым объектом.
Используйте событие DragOver для определения, что может случиться после инициализации операции перетаскивания и до того, как перетаскиваемый объект будет брошен на целевой объект. Например, вы можете проверить действенность области целевого объекта, подсветив его с помощью установки свойств BackColor или ForeColor и с помощью отображения индивидуального указателя мыши.