Table Tree Event: DropEnter (SAP-Bibliothek - SAP Automation RFC and BAPI Interfaces (BC-FES-AIT))

Table Tree Event: DropEnter

Purpose

Event-notification that the user has dragged data into a target control.

Syntax

The DropEnter event-handler has the syntax:

void DropEnter(Object DataObject, Long KeyState, Long * Effect, Short *Handled)

Parameters

DataObject: Data object containing the data being dragged

KeyState: (See the Visual Basic documentation.)

Effect: Return parameter telling what kind of drop is allowed

Handled: Parameter telling whether the container has handled the event

Description

The DropEnter event is fired when the mouse pointer is moved into the client area of a control during a drag-and-drop operation. The DataObject passed to the DropEnter event handler is a SAP Data Object that was originally filled in the DragSourceFill event. (The source control may be either a Table Tree or a Table View control.)

By calling the method IsFormatAvailable on the DataObject, your event handler can determine whether the DataObject contains acceptable information or not. If the DataObject is acceptable, set the Effect parameter to one of the following values in order to change the cursor accordingly:

Value	Description	Cursor
DROPEFFECT_NONE = 0	Drop is not possible
DROPEFFECT_COPY = 1	Drop of copy is possible
DROPEFFECT_MOVE = 2	Move of DataObject is possible

Set Handled to TRUE to prevent the control’s default drag-and-drop handling from being invoked.