Spread 8.0 Documentation
OLEDragOver, ScriptOLEDragOver Events
Support Options
ActiveX Reference > ActiveX Events > OLEDragOver, ScriptOLEDragOver Events

Glossary Item Box

OLEDragOver, ScriptOLEDragOver Events


See Also

Applies To

fpSpread and fpSpreadPreview controls

Description

Occurs when the mouse is moved over the target control during an OLE drag-drop operation.

Syntax

Visual Basic

Sub fpSpread_OLEDragOver(Data As fpDataObject, Effect As Long, Button As Integer, Shift As Integer, X As Single, Y As Single, State As Integer)

Sub fpSpreadPreview_OLEDragOver(Data As fpDataObject, Effect As Long, Button As Integer, Shift As Integer, x As Single, y As Single, State As Integer)

Note: The ScriptOLEDragOver event uses the same syntax except event parameters that are not passed "ByVal" are declared as variants. For more information on Script events, see Scripting Environment Usage.

Parameter

The following parameters are available:

Parameter Description
Data An fpDataObject object containing formats and possibly data the object being dropped will provide.
Effect Identifies the action or actions that can be performed
Using the Or operator, combine any of the following values:
Value Description
0 fpOLEDropEffectNone
1 fpOLEDropEffectCopy
2 fpOLEDropEffectMove
-2147483648 fpOLEDropEffectScroll
Button Indicates the state of the mouse button
Shift Indicates the state of the Shift, Ctrl, and Alt keys
x Location of the mouse pointer on the x-coordinate
y Location of the mouse pointer on the y-coordinate
State Transition state of the object being dragged in relation to the control
Use one of the following values:
Value Description
0 fpEnter
(when the pointer just enters the control area)
1 fpLeave
(when the pointer just leaves the control area)
2 fpOver
(when the pointer is over the control area)

Remarks

Note: If the State parameter is set to 2 (fpLeave), indicating the pointer is outside of the control, then the X and Y parameters will be set to zero.

The Effect parameters are initially set and passed to this event from the OLEStartDrag event (source control). These parameters must be set to an allowed effect by the target control during this event. The Effect parameters are passed from this event to the OLEGiveFeedback event (source control).

The OLEDropMode property must be set to 1 (fpOLEDropModeManual) for the OLEDragOver event to occur.

Note: This event will occur if you use the fpSpread or fpSpreadPreview control in a scripting environment (for example, Microsoft's Visual InterDev or Internet Explorer) or a non-scripting environment. However, if you want to use the fpSpread or fpSpreadPreview control in a scripting environment and you want to change any parameter that is not passed "ByVal", you must set the ScriptEnhanced property to True and use the ScriptOLEDragOver event. ScriptOLEDragOver event parameters that are not passed "ByVal" are declared as variants.

See Also

OLEDropMode, ScriptEnhanced properties

OLEDragDrop, OLEGiveFeedback, OLEStartDrag events

© 2002-2014 ComponentOne, a division of GrapeCity. All Rights Reserved.