Print this Page

Property : Drag Function

Back to Control Properties

Contents 1 Description 2 Function Signature 3 Property Editor Location 4 Data Type 5 Default Values

[edit] Description

Use the Drag Function property to assign a function interface for the purpose of overriding the default drag-and-drop functionality which is to simply copy or move the dropped data element to a destination control.

Important You must also assign the same function interface to the function you want to call, using the function's Interface List property.

[edit] Function Signature

When you create the function you want to call, you must add the following arguments in the order given.

Arg	Dir	Type	Name	Description
1st	[IN]	DragDrop	Drag Drop Object	Describes the source and destination of the dragged-and-dropped data element, together with many other details about the element.

Your function is not called until the end user drops the dragged object onto a destination control.

The drop machinery looks for a drop handler in the following order:

1. On the parent object of the destination field.
2. On the root object of the destination control.
3. If there is a linked field on the destination field, the linked field's parent.
4. If there is a linked field on the destination field, the linked object that owns the linked field.
5. Destination parent object, as defined in the DragDropObject
6. Top level control that owns the destination control.
7. Default collection machinery.

[edit] Property Editor Location

Interface Tab

[edit] Data Type

Path to Function Interface

[edit] Default Values

Control	Default Value
All Visual Controls	<not set>