Class DropTargetContext

• java.lang.Object
• • java.awt.dnd.DropTargetContext

All Implemented Interfaces:

Serializable

public class DropTargetContext
extends Object
implements Serializable

A DropTargetContext is created whenever the logical cursor associated with a Drag and Drop operation coincides with the visible geometry of a Component associated with a DropTarget. The DropTargetContext provides the mechanism for a potential receiver of a drop operation to both provide the end user with the appropriate drag under feedback, but also to effect the subsequent data transfer if appropriate.

Since:

1.2

Nested Classes

Nested Classes

Modifier and Type	Class and Description
protected class	DropTargetContext.TransferableProxy TransferableProxy is a helper inner class that implements Transferable interface and serves as a proxy for another Transferable object which represents data transfer for a particular drag-n-drop operation.

Methods

getDropTarget

public DropTarget getDropTarget()

Returns:

the DropTarget associated with this DropTargetContext

getComponent

public Component getComponent()

Returns:

the Component associated with this Context

addNotify

public void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)

Parameters:

dtcp - the DropTargetContextPeer

removeNotify

public void removeNotify()

Called when disassociated with the DropTargetContextPeer.

setTargetActions

protected void setTargetActions(int actions)

Parameters:

actions - an int representing the supported action(s)

getTargetActions

protected int getTargetActions()

Returns:

the current actions acceptable to this DropTarget

dropComplete

public void dropComplete(boolean success)
                  throws InvalidDnDOperationException

Parameters:

success - true for success, false if not

Throws:

InvalidDnDOperationException - if a drop is not outstanding/extant

acceptDrag

protected void acceptDrag(int dragOperation)

Parameters:

dragOperation - the supported action(s)

rejectDrag

protected void rejectDrag()

reject the Drag.

acceptDrop

protected void acceptDrop(int dropOperation)

Parameters:

dropOperation - the supported action(s)

rejectDrop

protected void rejectDrop()

called to signal that the drop is unacceptable. must be called during DropTargetListener.drop method invocation.

getCurrentDataFlavors

protected DataFlavor[] getCurrentDataFlavors()

Returns:

a DataFlavor[] containing the supported DataFlavors of the Transferable operand.

getCurrentDataFlavorsAsList

protected List<DataFlavor> getCurrentDataFlavorsAsList()

Returns:

the currently available DataFlavors as a java.util.List

isDataFlavorSupported

protected boolean isDataFlavorSupported(DataFlavor df)

Parameters:

df - the DataFlavor

Returns:

if the DataFlavor specified is supported

getTransferable

protected Transferable getTransferable()
                                throws InvalidDnDOperationException

Returns:

the Transferable

Throws:

InvalidDnDOperationException - if a drag is not outstanding/extant

createTransferableProxy

protected Transferable createTransferableProxy(Transferable t,
                                               boolean local)

Creates a TransferableProxy to proxy for the specified Transferable.

Parameters:

t - the Transferable to be proxied

local - true if t represents the result of a local drag-n-drop operation.

Returns:

the new TransferableProxy instance.