On Begin Drag Over

Code	Can be called by	Definition
17	4D Write Pro area - Button - Button Grid - Check Box - Dropdown list - Form - Hierarchical List - Input - List Box - List Box Column - Picture Button - Picture Pop up menu - Plug-in Area - Progress Indicators - Radio Button - Ruler - Spinner - Splitter - Stepper - Tab control	An object is being dragged

Description

The On Begin Drag Over form event can be selected for any form objects that can be dragged. It is generated in every case where the object has the Draggable property. It can be called from the method of the source object or the form method of the source object.

Unlike the On Drag Over form event, On Begin Drag Over is called within the context of the source object of the drag action.

The On Begin Drag Over event is useful for preparing of the drag action. It can be used to:

• Add data and signatures to the pasteboard (via the APPEND DATA TO PASTEBOARD command).
• Use a custom icon during the drag action (via the SET DRAG ICON command).
• Accept or refuse dragging via the result of the method of the dragged object.
  • To indicate that drag actions are accepted, the method of the source object must return 0 (zero).
  • To indicate that drag actions are refused, the method of the source object must return -1 (minus one).
  • If no result is returned, 4D considers that drag actions are accepted.

4D data are put in the pasteboard before calling the event. For example, in the case of dragging without the Automatic Drag action, the dragged text is already in the pasteboard when the event is called.