- java.lang.Object
-
- java.awt.dnd.DropTargetContext
-
- All Implemented Interfaces:
- Serializable
public class DropTargetContext extends Object implements Serializable
ADropTargetContext
is created whenever the logical cursor associated with a Drag and Drop operation coincides with the visible geometry of aComponent
associated with aDropTarget
. TheDropTargetContext
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
Nested Classes Modifier and Type Class and Description protected class
DropTargetContext.TransferableProxy
TransferableProxy
is a helper inner class that implementsTransferable
interface and serves as a proxy for anotherTransferable
object which represents data transfer for a particular drag-n-drop operation.
-
Method Summary
Methods 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 theDropTargetContextPeer
.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 theComponent
associated with thisDropTargetContext
.protected DataFlavor[]
getCurrentDataFlavors()
get the available DataFlavors of theTransferable
operand of this operation.protected List<DataFlavor>
getCurrentDataFlavorsAsList()
This method returns a the currently available DataFlavors of theTransferable
operand as ajava.util.List
.DropTarget
getDropTarget()
This method returns theDropTarget
associated with thisDropTargetContext
.protected int
getTargetActions()
This method returns anint
representing the current actions thisDropTarget
will accept.protected Transferable
getTransferable()
get the Transferable (proxy) operand of this operationprotected boolean
isDataFlavorSupported(DataFlavor df)
This method returns aboolean
indicating if the givenDataFlavor
is supported by thisDropTargetContext
.protected void
rejectDrag()
reject the Drag.protected void
rejectDrop()
called to signal that the drop is unacceptable.void
removeNotify()
Called when disassociated with theDropTargetContextPeer
.protected void
setTargetActions(int actions)
This method sets the current actions acceptable to thisDropTarget
.
-
-
-
Method Detail
-
getDropTarget
public DropTarget getDropTarget()
This method returns theDropTarget
associated with thisDropTargetContext
.- Returns:
- the
DropTarget
associated with thisDropTargetContext
-
getComponent
public Component getComponent()
This method returns theComponent
associated with thisDropTargetContext
.- Returns:
- the Component associated with this Context
-
addNotify
public void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
Called when associated with theDropTargetContextPeer
.- Parameters:
dtcp
- theDropTargetContextPeer
-
removeNotify
public void removeNotify()
Called when disassociated with theDropTargetContextPeer
.
-
setTargetActions
protected void setTargetActions(int actions)
This method sets the current actions acceptable to thisDropTarget
.- Parameters:
actions
- anint
representing the supported action(s)
-
getTargetActions
protected int getTargetActions()
This method returns anint
representing the current actions thisDropTarget
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 theTransferable
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 theTransferable
operand as ajava.util.List
.- Returns:
- the currently available
DataFlavors as a
java.util.List
-
isDataFlavorSupported
protected boolean isDataFlavorSupported(DataFlavor df)
This method returns aboolean
indicating if the givenDataFlavor
is supported by thisDropTargetContext
.- 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
- the Transferable to be proxiedlocal
- true if t represents the result of a local drag-n-drop operation.- Returns:
- the new TransferableProxy instance.
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/awt/dnd/DropTargetContext.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.