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.

Modifier and Type	Field and Description
private final DropTarget	dropTarget The DropTarget associated with this DropTargetContext.
private transient DropTargetContextPeer	dropTargetContextPeer
private static final long	serialVersionUID Use serialVersionUID from JDK 1.4 for interoperability.
private transient Transferable	transferable

Access	Constructor and Description
pack-priv	DropTargetContext(DropTarget the DropTarget to associate with dt) Construct a `DropTargetContext` given a specified `DropTarget`.

Method Summary

Modifier and Type	Method and Description
protected void	acceptDrag(int the supported action(s) dragOperation) accept the Drag.
protected void	acceptDrop(int the supported action(s) dropOperation) called to signal that the drop is acceptable using the specified operation.
protected Transferable	Returns: the new `TransferableProxy` instance. createTransferableProxy(Transferable the `Transferable` to be proxied t, boolean `true` if `t` represents the result of a local drag-n-drop operation. local) Creates a TransferableProxy to proxy for the specified Transferable.
public void	dropComplete(boolean true for success, false if not success) This method signals that the drop is completed and if it was successful or not.
public Component	Returns: the Component associated with this Context getComponent() This method returns the `Component` associated with this `DropTargetContext`.
protected DataFlavor[]	Returns: a `DataFlavor[]` containing the supported `DataFlavor`s of the `Transferable` operand. getCurrentDataFlavors() get the available DataFlavors of the `Transferable` operand of this operation.
protected List<DataFlavor>	Returns: the currently available DataFlavors as a `java.util.List` getCurrentDataFlavorsAsList() This method returns the currently available DataFlavors of the `Transferable` operand as a `java.util.List`.
public DropTarget	Returns: the `DropTarget` associated with this `DropTargetContext` getDropTarget() This method returns the `DropTarget` associated with this `DropTargetContext`.
pack-priv DropTargetContextPeer	Returns: the platform peer getDropTargetContextPeer() Get the `DropTargetContextPeer`
protected int	Returns: the current actions acceptable to this `DropTarget` getTargetActions() This method returns an `int` representing the current actions this `DropTarget` will accept.
protected Transferable	Returns: the `Transferable` getTransferable() get the Transferable (proxy) operand of this operation
protected boolean	Returns: `true` if the `DataFlavor` specified is supported, otherwise `false` isDataFlavorSupported(DataFlavor the `DataFlavor` to test df) This method returns a `boolean` indicating if the given `DataFlavor` is supported by this `DropTargetContext`.
protected void	rejectDrag() reject the Drag.
protected void	rejectDrop() called to signal that the drop is unacceptable.
pack-priv void	reset() Called when disassociated with the `DropTargetContextPeer`.
pack-priv void	setDropTargetContextPeer(final DropTargetContextPeer dtcp) Sets the `DropTargetContextPeer`
protected void	setTargetActions(int an `int` representing the supported action(s) actions) This method sets the current actions acceptable to this `DropTarget`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

dropTarget	back to summary
private final DropTarget dropTarget The DropTarget associated with this DropTargetContext.

dropTargetContextPeer	back to summary
private transient DropTargetContextPeer dropTargetContextPeer

serialVersionUID	back to summary
private static final long serialVersionUID Use serialVersionUID from JDK 1.4 for interoperability. Annotations @Serial

transferable	back to summary
private transient Transferable transferable

DropTargetContext	back to summary
pack-priv DropTargetContext(DropTarget dt) Construct a `DropTargetContext` given a specified `DropTarget`. Parameters dt:DropTarget the DropTarget to associate with

Method Detail

acceptDrag	back to summary
protected void acceptDrag(int dragOperation) accept the Drag. Parameters dragOperation:int the supported action(s)

acceptDrag

back to summary

protected void acceptDrag(int dragOperation)

accept the Drag.

Parameters

dragOperation:int: the supported action(s)

acceptDrop	back to summary
protected void acceptDrop(int dropOperation) called to signal that the drop is acceptable using the specified operation. must be called during DropTargetListener.drop method invocation. Parameters dropOperation:int the supported action(s)

acceptDrop

back to summary

protected void acceptDrop(int dropOperation)

called to signal that the drop is acceptable using the specified operation. must be called during DropTargetListener.drop method invocation.

Parameters

dropOperation:int: the supported action(s)

createTransferableProxy back to summary

createTransferableProxy	back to summary
protected Transferable createTransferableProxy(Transferable t, boolean local) Creates a TransferableProxy to proxy for the specified Transferable. Parameters t:Transferable the `Transferable` to be proxied local:boolean `true` if `t` represents the result of a local drag-n-drop operation. Returns:Transferable the new `TransferableProxy` instance.

protected Transferable createTransferableProxy(Transferable t, boolean local)

Creates a TransferableProxy to proxy for the specified Transferable.

Parameters

t:Transferable: the Transferable to be proxied
local:boolean: true if t represents the result of a local drag-n-drop operation.

Returns:Transferable

the new TransferableProxy instance.

dropComplete	back to summary
public void dropComplete(boolean success) throws InvalidDnDOperationException This method signals that the drop is completed and if it was successful or not. Parameters success:boolean true for success, false if not Exceptions InvalidDnDOperationException: if a drop is not outstanding/extant

dropComplete

back to summary

public void dropComplete(boolean success) throws InvalidDnDOperationException

This method signals that the drop is completed and if it was successful or not.

Parameters

success:boolean: true for success, false if not

Exceptions

InvalidDnDOperationException:: if a drop is not outstanding/extant

getComponent back to summary

getComponent	back to summary
public Component getComponent() This method returns the `Component` associated with this `DropTargetContext`. Returns:Component the Component associated with this Context

public Component getComponent()

This method returns the Component associated with this DropTargetContext.

Returns:Component: the Component associated with this Context

getCurrentDataFlavors back to summary

getCurrentDataFlavors	back to summary
protected DataFlavor[] getCurrentDataFlavors() get the available DataFlavors of the `Transferable` operand of this operation. Returns:DataFlavor[] a `DataFlavor[]` containing the supported `DataFlavor`s of the `Transferable` operand.

protected DataFlavor[] getCurrentDataFlavors()

get the available DataFlavors of the Transferable operand of this operation.

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

getCurrentDataFlavorsAsList back to summary

getCurrentDataFlavorsAsList	back to summary
protected List<DataFlavor> getCurrentDataFlavorsAsList() This method returns the currently available DataFlavors of the `Transferable` operand as a `java.util.List`. Returns:List<DataFlavor> the currently available DataFlavors as a `java.util.List`

protected List<DataFlavor> getCurrentDataFlavorsAsList()

This method returns the currently available DataFlavors of the Transferable operand as a java.util.List.

Returns:List<DataFlavor>: the currently available DataFlavors as a java.util.List

getDropTarget back to summary

getDropTarget	back to summary
public DropTarget getDropTarget() This method returns the `DropTarget` associated with this `DropTargetContext`. Returns:DropTarget the `DropTarget` associated with this `DropTargetContext`

public DropTarget getDropTarget()

This method returns the DropTarget associated with this DropTargetContext.

Returns:DropTarget: the DropTarget associated with this DropTargetContext

getDropTargetContextPeer back to summary

getDropTargetContextPeer	back to summary
pack-priv DropTargetContextPeer getDropTargetContextPeer() Get the `DropTargetContextPeer` Returns:DropTargetContextPeer the platform peer

pack-priv DropTargetContextPeer getDropTargetContextPeer()

Get the DropTargetContextPeer

Returns:DropTargetContextPeer: the platform peer

getTargetActions back to summary

getTargetActions	back to summary
protected int getTargetActions() This method returns an `int` representing the current actions this `DropTarget` will accept. Returns:int the current actions acceptable to this `DropTarget`

protected int getTargetActions()

This method returns an int representing the current actions this DropTarget will accept.

Returns:int: the current actions acceptable to this DropTarget

getTransferable back to summary

getTransferable	back to summary
protected Transferable getTransferable() throws InvalidDnDOperationException get the Transferable (proxy) operand of this operation Returns:Transferable the `Transferable` Exceptions InvalidDnDOperationException: if a drag is not outstanding/extant

protected Transferable getTransferable() throws InvalidDnDOperationException

get the Transferable (proxy) operand of this operation

Returns:Transferable

the Transferable

Exceptions

InvalidDnDOperationException:: if a drag is not outstanding/extant

isDataFlavorSupported back to summary

isDataFlavorSupported	back to summary
protected boolean isDataFlavorSupported(DataFlavor df) This method returns a `boolean` indicating if the given `DataFlavor` is supported by this `DropTargetContext`. Parameters df:DataFlavor the `DataFlavor` to test Returns:boolean `true` if the `DataFlavor` specified is supported, otherwise `false`

protected boolean isDataFlavorSupported(DataFlavor df)

This method returns a boolean indicating if the given DataFlavor is supported by this DropTargetContext.

Parameters

df:DataFlavor: the DataFlavor to test

Returns:boolean

true if the DataFlavor specified is supported, otherwise false

rejectDrag	back to summary
protected void rejectDrag() reject the Drag.

rejectDrop	back to summary
protected void rejectDrop() called to signal that the drop is unacceptable. must be called during DropTargetListener.drop method invocation.

reset	back to summary
pack-priv void reset() Called when disassociated with the `DropTargetContextPeer`.

setDropTargetContextPeer	back to summary
pack-priv void setDropTargetContextPeer(final DropTargetContextPeer dtcp) Sets the `DropTargetContextPeer`

setTargetActions back to summary

setTargetActions	back to summary
protected void setTargetActions(int actions) This method sets the current actions acceptable to this `DropTarget`. Parameters actions:int an `int` representing the supported action(s)

protected void setTargetActions(int actions)

This method sets the current actions acceptable to this DropTarget.

Parameters

actions:int: an int representing the supported action(s)

java.awt.dnd back to summary

protected Class DropTargetContext.TransferableProxy

Class Inheritance

extends Object
implements Transferable

java.lang.Object
java.awt.dnd.DropTargetContext.TransferableProxy

All Implemented Interfaces

java.awt.datatransfer.Transferable

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.

The proxy forwards all requests to the encapsulated transferable and automatically performs additional conversion on the data returned by the encapsulated transferable in case of local transfer.

Field Summary

Modifier and Type	Field and Description
protected boolean	isLocal A `boolean` indicating if the encapsulated `Transferable` object represents the result of local drag-n-drop operation (within the same JVM).
private TransferableProxy	proxy
protected Transferable	transferable The encapsulated `Transferable` object.

Constructor Summary

Access	Constructor and Description
pack-priv	TransferableProxy(Transferable the `Transferable` object t, boolean `true`, if `t` represents the result of local drag-n-drop operation local) Constructs a `TransferableProxy` given a specified `Transferable` object representing data transfer for a particular drag-n-drop operation and a `boolean` which indicates whether the drag-n-drop operation is local (within the same JVM).

Method Summary

Modifier and Type	Method and Description
public Object	getTransferData(DataFlavor the requested flavor for the data df) Implements java.awt.datatransfer.Transferable.getTransferData. Returns an object which represents the data provided by the encapsulated transferable for the requested data flavor.
public DataFlavor[]	Returns: an array of data flavors in which the data can be provided by the encapsulated transferable getTransferDataFlavors() Implements java.awt.datatransfer.Transferable.getTransferDataFlavors. Returns an array of DataFlavor objects indicating the flavors the data can be provided in by the encapsulated transferable.
public boolean	Returns: `true` if the data flavor is supported, `false` otherwise isDataFlavorSupported(DataFlavor the requested flavor for the data flavor) Implements java.awt.datatransfer.Transferable.isDataFlavorSupported. Returns whether or not the specified data flavor is supported by the encapsulated transferable.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

isLocal	back to summary
protected boolean isLocal A `boolean` indicating if the encapsulated `Transferable` object represents the result of local drag-n-drop operation (within the same JVM).

proxy	back to summary
private TransferableProxy proxy

transferable	back to summary
protected Transferable transferable The encapsulated `Transferable` object.

Constructor Detail

TransferableProxy back to summary

TransferableProxy	back to summary
pack-priv TransferableProxy(Transferable t, boolean local) Constructs a `TransferableProxy` given a specified `Transferable` object representing data transfer for a particular drag-n-drop operation and a `boolean` which indicates whether the drag-n-drop operation is local (within the same JVM). Parameters t:Transferable the `Transferable` object local:boolean `true`, if `t` represents the result of local drag-n-drop operation

pack-priv TransferableProxy(Transferable t, boolean local)

Constructs a TransferableProxy given a specified Transferable object representing data transfer for a particular drag-n-drop operation and a boolean which indicates whether the drag-n-drop operation is local (within the same JVM).

Parameters

t:Transferable: the Transferable object
local:boolean: true, if t represents the result of local drag-n-drop operation

Method Detail

getTransferData	back to summary
public Object getTransferData(DataFlavor df) throws UnsupportedFlavorException, IOException Implements java.awt.datatransfer.Transferable.getTransferData. Returns an object which represents the data provided by the encapsulated transferable for the requested data flavor. In case of local transfer a serialized copy of the object returned by the encapsulated transferable is provided when the data is requested in application/x-java-serialized-object data flavor. Parameters df:DataFlavor the requested flavor for the data Exceptions UnsupportedFlavorException: if the requested data flavor is not supported. IOException: if the data is no longer available in the requested flavor.

getTransferData

back to summary

public Object getTransferData(DataFlavor df) throws UnsupportedFlavorException, IOException

Implements java.awt.datatransfer.Transferable.getTransferData.

Returns an object which represents the data provided by the encapsulated transferable for the requested data flavor.

In case of local transfer a serialized copy of the object returned by the encapsulated transferable is provided when the data is requested in application/x-java-serialized-object data flavor.

Parameters

df:DataFlavor: the requested flavor for the data

Exceptions

UnsupportedFlavorException:: if the requested data flavor is not supported.
IOException:: if the data is no longer available in the requested flavor.

getTransferDataFlavors	back to summary
public DataFlavor[] getTransferDataFlavors() Implements java.awt.datatransfer.Transferable.getTransferDataFlavors. Returns an array of DataFlavor objects indicating the flavors the data can be provided in by the encapsulated transferable. Returns:DataFlavor[] an array of data flavors in which the data can be provided by the encapsulated transferable

getTransferDataFlavors

back to summary

public DataFlavor[] getTransferDataFlavors()

Implements java.awt.datatransfer.Transferable.getTransferDataFlavors.

Returns an array of DataFlavor objects indicating the flavors the data can be provided in by the encapsulated transferable.

Returns:DataFlavor[]: an array of data flavors in which the data can be provided by the encapsulated transferable

isDataFlavorSupported back to summary

isDataFlavorSupported	back to summary
public boolean isDataFlavorSupported(DataFlavor flavor) Implements java.awt.datatransfer.Transferable.isDataFlavorSupported. Returns whether or not the specified data flavor is supported by the encapsulated transferable. Parameters flavor:DataFlavor the requested flavor for the data Returns:boolean `true` if the data flavor is supported, `false` otherwise

public boolean isDataFlavorSupported(DataFlavor flavor)

Implements java.awt.datatransfer.Transferable.isDataFlavorSupported.

Returns whether or not the specified data flavor is supported by the encapsulated transferable.

Parameters

flavor:DataFlavor: the requested flavor for the data

Returns:boolean

true if the data flavor is supported, false otherwise

public final Class DropTargetContext

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

protected Class DropTargetContext.TransferableProxy

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail