OLEGiveFeedback Event

  • Article

Occurs after every OLEDragOver event. Allows the drag source to specify the type of OLE drag-and-drop operation and the visual feedback.

PROCEDURE Object.OLEGiveFeedback
LPARAMETERS nEffect, eMouseCursor

Return Value

  • nEffect
    The action performed when data is dropped on the drop target. The value of nEffect is set by the drop target in its OLEDragOver event. The following table lists the values for nEffect with a description of each action.

    nEffect Foxpro.h constant Description

    0

    DROPEFFECT_NONE

    Drop target cannot accept the data.

    1

    DROPEFFECT_COPY

    Drop results in a copy.

    2

    DROPEFFECT_MOVE

    Drop results in a move.

    4

    DROPEFFECT_LINK

    Drop results in a link.

  • eMouseCursor
    Specifies the mouse pointer displayed during the OLE drag-and-drop operation. eMouseCursor can be a character or numeric value. eMouseCursor is an output parameter and is set to zero on entry into event.

    If eMouseCursor is a character value, it's assumed that the character value is the name of a graphics file of type .ani, .cur, or .ico. If eMouseCursor is a numeric value, the value specifies the mouse pointer displayed. The following table lists the numeric values for eMouseCursor with a description of each mouse pointer.

    eMouseCursor Foxpro.h constant Description

    0

    MOUSE_DEFAULT

    Shape determined by the object. (Default)

    1

    MOUSE_ARROW

    Arrow.

    2

    MOUSE_CROSSHAIR

    Cross. A cross-hair pointer.

    3

    MOUSE_IBEAM

    I-Beam.

    4

    MOUSE_ICON_POINTER

    Icon. A small white square within a black square.

    5

    MOUSE_SIZE_POINTER

    Size. A four-pointed arrow pointing north, south, east, west.

    6

    MOUSE_SIZE_NE_SW

    Size NE SW. A double arrow pointing northeast and southwest.

    7

    MOUSE_SIZE_N_S

    Size NS. A double arrow pointing north and south.

    8

    MOUSE_SIZE_NW_SE

    Size NW SE. A double arrow pointing northwest and southeast.

    9

    MOUSE_W_E

    Size WE. A double arrow pointing west and east.

    10

    MOUSE_UP_ARROW

    Up Arrow.

    11

    MOUSE_HOURGLASS

    Hourglass.

    12

    MOUSE_NO_DROP

    No Drop.

    13

    MOUSE_HIDE_POINTER

    Hide Pointer.

    14

    MOUSE_ARROW2

    Arrow.

    15

    MOUSE_ARROW_HOURGLASS

    Arrow and hourglass.

    16

    MOUSE_ARROW_QUESTION

    Arrow and question mark.

Remarks

Applies To: CheckBox | ComboBox | CommandButton | CommandGroup | Container Object | Control Object | EditBox | Form | Grid | Image | Label | Line | ListBox | OptionButton | OptionGroup | Page | PageFrame | ProjectHook Object | Shape | Spinner | TextBox | ToolBar

OLEGiveFeedback is a drag source event that lets you provide visual feedback to the user. You can change the mouse cursor to indicate the operation that occurs when the mouse is positioned over the drag source or the drop target. Including NODEFAULT has no effect on the behavior of this method.

Note that you should avoid creating wait states in the OLEGiveFeedback event with commands and functions such as WAIT WINDOW and MESSAGEBOX( ).

See Also

Reference

OLE Drag-and-Drop
OLEDragOver Event
NODEFAULT Command

Other Resources

Events (Visual FoxPro)