Drag-Over Event

This document covers the following topics:


Applies To

Dialog, ActiveX Controls, Bitmap Control, Control Box Control, Edit Area Control, List Box Control, List View Control, Tree View Control.

Description

If not suppressed, this event is received by the drop target (see the DROP-MODE attribute) under the drag cursor when the drag cursor traverses the area occupied by the drop target during a drag-drop operation.

Applications typically use this event to dynamically enable or disable a drop according to the position within the drop target (as returned by the INQ-DRAG-DROP action) by setting the SUPPRESS-DRAG-DROP-EVENT attribute accordingly. Alternatively, or additionally, this event can be used to highlight this drop position. For example, if the drop target is an ActiveX tree view control, the tree view node where the drop would currently occur could be marked as selected. If the effect of the drop is not position-dependent, this event can be left suppressed.

Note:
This event is raised frequently during a drag-drop operation. Therefore, the application's drag-over event handler (if any) should be made as performant as possible (e.g., by performing position-independent tasks in the drag-enter event instead).