public class DropTargetContext extends Object implements Serializable
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.| 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 | Method and 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.
|
void |
addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
Called when associated with the
DropTargetContextPeer. |
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
Component associated with
this DropTargetContext. |
protected DataFlavor[] |
getCurrentDataFlavors()
get the available DataFlavors of the
Transferable operand of this operation. |
protected List<DataFlavor> |
getCurrentDataFlavorsAsList()
This method returns a the currently available DataFlavors
of the
Transferable operand
as a java.util.List. |
DropTarget |
getDropTarget()
This method returns the
DropTarget associated with this
DropTargetContext. |
protected int |
getTargetActions()
This method returns an
int representing the
current actions this DropTarget will accept. |
protected Transferable |
getTransferable()
get the Transferable (proxy) operand of this operation
|
protected boolean |
isDataFlavorSupported(DataFlavor 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.
|
void |
removeNotify()
Called when disassociated with the
DropTargetContextPeer. |
protected void |
setTargetActions(int actions)
This method sets the current actions acceptable to
this
DropTarget. |
public DropTarget getDropTarget()
DropTarget associated with this
DropTargetContext.
DropTarget associated with this DropTargetContextpublic Component getComponent()
Component associated with
this DropTargetContext.
public void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
DropTargetContextPeer.
dtcp - the DropTargetContextPeerpublic void removeNotify()
DropTargetContextPeer.protected void setTargetActions(int actions)
DropTarget.
actions - an int representing the supported action(s)protected int getTargetActions()
int representing the
current actions this DropTarget will accept.
DropTargetpublic void dropComplete(boolean success)
throws InvalidDnDOperationException
success - true for success, false if not
InvalidDnDOperationException - if a drop is not outstanding/extantprotected void acceptDrag(int dragOperation)
dragOperation - the supported action(s)protected void rejectDrag()
protected void acceptDrop(int dropOperation)
dropOperation - the supported action(s)protected void rejectDrop()
protected DataFlavor[] getCurrentDataFlavors()
Transferable operand of this operation.
DataFlavor[] containing the
supported DataFlavors of the
Transferable operand.protected List<DataFlavor> getCurrentDataFlavorsAsList()
Transferable operand
as a java.util.List.
java.util.Listprotected boolean isDataFlavorSupported(DataFlavor df)
boolean
indicating if the given DataFlavor is
supported by this DropTargetContext.
df - the DataFlavor
DataFlavor specified is supportedprotected Transferable getTransferable() throws InvalidDnDOperationException
TransferableInvalidDnDOperationException - if a drag is not outstanding/extant
protected Transferable createTransferableProxy(Transferable t, boolean local)
t - the Transferable to be proxiedlocal - true if t represents
the result of a local drag-n-drop operation. Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2018, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.