The dragDropSpec property specifies the drag and drop
information for the part.
You can tear-off the dragDropSpec property to access its
properties and events. If the part has a Drag/Drop tab in
its Settings window, the drag and drop properties and events will be added to
the part once you have selected either Allow drag or Allow
drop in the part's Settings window.
The dragDropSpec property has the following properties for
specifying drag and drop information:
- canBeDragSource (Boolean)
- Specifies whether the part can be the source of a drag operation.
The source is where the drag is started.
- canBeDragTarget (Boolean)
- Specifies whether the part can be the target of a drag operation.
The target is the part under the cursor during the drag.
- defaultDragOperations (OrderedCollection)
- Specifies the following default drag operations for the array of any or
all elements, with the first elements having the highest priority:
- XmMOVE
- XmCOPY
- XmLINK
- XmILLEGAL
- defaultDropOperations (OrderedCollection)
- Specifies the following default drop operations for the array of any or
all elements, with the first elements having the highest priority:
- XmMOVE
- XmCOPY
- XmLINK
- XmILLEGAL
- dropAcceptableClassList (OrderedCollection)
- Specifies a list of classes where instances can be added to the part for a
drop operation.
The dragDropSpec property has the following drag and drop
events, which all pass a callData parameter from which it gets information
about the source, target, operation, and emphasis:
- dragChanged
- Signals to the source that the target or operation of the drag session has
changed.
- dragCompleteRequested
- Signals to the source that the drag session has completed and requests
that the source perform any necessary actions for the operation.
- dragLeave
- Signals to the target that the mouse pointer has left its bounding box
during a drag session. You may want to use this for changing the target
emphasis.
- dragOver
- Signals to the target that the mouse pointer is moving over it during a
drag session. The target must fill in the vote field of the callData
parameter with the operation acceptable with regard to the source
items. See the defaultDropOperations attribute for
acceptable vote values.
- dragSourceCancelled
- Signals to the source that the drag operation was cancelled.
- dragStartRequested
- Signals to the source that the drag session has started. The source
items, images and offsets must be filled in the respective fields of the
callData parameter.
- dragTargetCancelled
- Signals to the target that the drag operation was cancelled.
- dropped
- Signals to the target that the dragged items have been dropped and
requests that the target perform any actions necessary for the drop
operation.