public class ResourceDropAdapterAssistant extends CommonDropAdapterAssistant
Clients may not extend or instantiate this class for any purpose. Clients may have no direct dependencies on the contract of this class.
Constructor and Description |
---|
ResourceDropAdapterAssistant() |
Modifier and Type | Method and Description |
---|---|
IStatus |
handleDrop(CommonDropAdapter aDropAdapter,
DropTargetEvent aDropTargetEvent,
Object aTarget)
Carry out the DND operation.
|
IStatus |
handlePluginTransferDrop(IStructuredSelection aDragSelection,
Object aDropTarget)
Handle the drop operation for the target viewer.
|
boolean |
isSupportedType(TransferData aTransferType)
Clients may extend the supported transfer types beyond the default
LocalSelectionTransfer.getTransfer() and
PluginTransfer.getInstance() transfer types. |
IStatus |
validateDrop(Object target,
int aDropOperation,
TransferData transferType)
Validates dropping on the given object.
|
IStatus |
validatePluginTransferDrop(IStructuredSelection aDragSelection,
Object aDropTarget)
Return true if the client can handle the drop onto the target viewer of
the drop operation.
|
doInit, getCommonDropAdapter, getContentService, getCurrentEvent, getShell, init, setCommonDropAdapter
public boolean isSupportedType(TransferData aTransferType)
CommonDropAdapterAssistant
LocalSelectionTransfer.getTransfer()
and
PluginTransfer.getInstance()
transfer types. When a transfer type
other than one of these is encountered, the DND Service will query the
visible and active descriptors that are enabled
for the drop target of the current operation.isSupportedType
in class CommonDropAdapterAssistant
aTransferType
- The transfer data from the drop operationpublic IStatus validateDrop(Object target, int aDropOperation, TransferData transferType)
CommonDropAdapterAssistant
Subclasses must implement this method to define which drops make sense.
If clients return true, then they will be allowed to handle the drop in
CommonDropAdapterAssistant.handleDrop(CommonDropAdapter, DropTargetEvent, Object)
.
validateDrop
in class CommonDropAdapterAssistant
target
- the object that the mouse is currently hovering over, or
null
if the mouse is hovering over empty spaceaDropOperation
- the current drag operation (copy, move, etc.)transferType
- the current transfer typepublic IStatus handleDrop(CommonDropAdapter aDropAdapter, DropTargetEvent aDropTargetEvent, Object aTarget)
CommonDropAdapterAssistant
Note: Contrary to the SWT DropTargetListener
specification, you
must make sure that the aDropTargetEvent.detail is not set to
DND.DROP_MOVE unless actual work is required in the
DragSourceListener.dragFinished(org.eclipse.swt.dnd.DragSourceEvent)
to complete the operation (for example removing the moved file). In
particular for the LocalSelectionTransfer case, DND.DROP_MOVE cannot be
used as it will cause incorrect behavior in some existing drag handlers.
In case of move operations where no action is required on the source side
(e.g. LocalSelectionTransfer) you must set aDropTargetEvent.detail to
DND.DROP_NONE to signal this to the drag source. Even though the SWT
specification says this is canceling the drop, it is not really doing so,
it is only preventing the DND.DROP_MOVE from being passed through to the
dragFinished() method.
handleDrop
in class CommonDropAdapterAssistant
aDropAdapter
- The Drop Adapter contains information that has already been
parsed from the drop event.aDropTargetEvent
- The drop target event.aTarget
- The object being dragged ontopublic IStatus validatePluginTransferDrop(IStructuredSelection aDragSelection, Object aDropTarget)
CommonDropAdapterAssistant
The default behavior of this method is to return Status.CANCEL_STATUS.
validatePluginTransferDrop
in class CommonDropAdapterAssistant
aDragSelection
- The selection dragged from the viewer.aDropTarget
- The target of the drop operation.public IStatus handlePluginTransferDrop(IStructuredSelection aDragSelection, Object aDropTarget)
CommonDropAdapterAssistant
The default behavior of this method is to return Status.CANCEL_STATUS.
handlePluginTransferDrop
in class CommonDropAdapterAssistant
aDragSelection
- The selection dragged from the viewer.aDropTarget
- The target of the drop operation.
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.