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
- See Also:
- Serialized Form
Nested Class Summary
Modifier and Type | Class | Description |
---|---|---|
protected class | DropTargetContext.TransferableProxy |
|
Method Summary
Modifier and Type | Method | Description |
---|---|---|
protected void | acceptDrag(int dragOperation) | accept the Drag. |
protected void | acceptDrop(int dropOperation) | called to signal that the drop is acceptable using the specified operation. |
protected Transferable | createTransferableProxy(Transferable t,
boolean local) | Creates a TransferableProxy to proxy for the specified Transferable. |
void | dropComplete(boolean success) | This method signals that the drop is completed and if it was successful or not. |
Component | getComponent() | This method returns the |
protected DataFlavor[] | getCurrentDataFlavors() | get the available DataFlavors of the |
protected List<DataFlavor> | getCurrentDataFlavorsAsList() | This method returns a the currently available DataFlavors of the |
DropTarget | getDropTarget() | This method returns the |
protected int | getTargetActions() | This method returns an |
protected Transferable | getTransferable() | get the Transferable (proxy) operand of this operation |
protected boolean | isDataFlavorSupported(DataFlavor df) | This method returns a |
protected void | rejectDrag() | reject the Drag. |
protected void | rejectDrop() | called to signal that the drop is unacceptable. |
protected void | setTargetActions(int actions) | This method sets the current actions acceptable to this |
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Method Detail
getDropTarget
public DropTarget getDropTarget()
This method returns the DropTarget
associated with this DropTargetContext
.
- Returns:
- the
DropTarget
associated with thisDropTargetContext
getComponent
public Component getComponent()
This method returns the Component
associated with this DropTargetContext
.
- Returns:
- the Component associated with this Context
setTargetActions
protected void setTargetActions(int actions)
This method sets the current actions acceptable to this DropTarget
.
- Parameters:
-
actions
- anint
representing the supported action(s)
getTargetActions
protected int getTargetActions()
This method returns an int
representing the current actions this DropTarget
will accept.
- Returns:
- the current actions acceptable to this
DropTarget
dropComplete
public void dropComplete(boolean success) throws InvalidDnDOperationException
This method signals that the drop is completed and if it was successful or not.
- Parameters:
-
success
- true for success, false if not - Throws:
-
InvalidDnDOperationException
- if a drop is not outstanding/extant
acceptDrag
protected void acceptDrag(int dragOperation)
accept the Drag.
- Parameters:
-
dragOperation
- the supported action(s)
rejectDrag
protected void rejectDrag()
reject the Drag.
acceptDrop
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
- 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()
get the available DataFlavors of the Transferable
operand of this operation.
- Returns:
- a
DataFlavor[]
containing the supportedDataFlavor
s of theTransferable
operand.
getCurrentDataFlavorsAsList
protected List<DataFlavor> getCurrentDataFlavorsAsList()
This method returns a the currently available DataFlavors of the Transferable
operand as a java.util.List
.
- Returns:
- the currently available DataFlavors as a
java.util.List
isDataFlavorSupported
protected boolean isDataFlavorSupported(DataFlavor df)
This method returns a boolean
indicating if the given DataFlavor
is supported by this DropTargetContext
.
- Parameters:
-
df
- theDataFlavor
- Returns:
- if the
DataFlavor
specified is supported
getTransferable
protected Transferable getTransferable() throws InvalidDnDOperationException
get the Transferable (proxy) operand of this operation
- 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
- theTransferable
to be proxied -
local
-true
ift
represents the result of a local drag-n-drop operation. - Returns:
- the new
TransferableProxy
instance.