DropTarget

The DropTarget logical widget accepts input dragged from a DragSource, other Uniface application, or Microsoft Windows Explorer. The data that is transferred consists of a Uniface list.

For more information, see Specifying a Widget for a Field or Entity.

Widget Overview

Logical widget name:

DropTarget

Maps to physical widget:

udragdrop

Default definition:

DropTarget=udragdrop(target=on;label=on;targetfeedback=copy,move;targethilite=halftone)

Supported triggers and properties:

See udragdrop.

Use for:

String data

Description

The DropTarget can only accept objects that match one of the entries in its ValRep definition. When defining the ValRep of a DropTarget, create an entry with a value of GOLD * to display any value of the field not individually listed.

When a DropTarget represents an action (for example, print, delete) rather than a container (for example, a directory or field list), it usually sets up its ValRep differently.

When the mouse pointer is over the target, and if the object being dragged matches an entry in the target’s ValRep definition, the mouse pointer changes from the no entry sign to something more appropriate. When the user releases the mouse button (and the object is acceptable) the contents of the source are copied to the target. The target then fires its valueChanged trigger.

Use the valueChanged and detail triggers to achieve more complicated behavior than just the transfer of values.

For targets that accept both copy's and moves, $result should be inspected to determine the type of operation selected by the user.

One or more files can be dragged from the Microsoft Windows File Manager or Explorer to a DropTarget that includes file (or the wildcard) in its ValRep. The object that is dropped has file in the first item, and all selected file names (fully qualified) in the following list items.

Note:  If Uniface (ide.exe or uniface.exe) is run as administrator, it may not be possible to drag and drop from Windows Explorer to Uniface. This is because different security policies are applied in the source and target applications.

Related Topics