java.awt.dnd

Class DragSource

java.lang.Object

java.awt.dnd.DragSource

All Implemented Interfaces:

java.io.Serializable

public class DragSource
extends java.lang.Object
implements java.io.Serializable

Since:

1.2

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.awt.Cursor	DefaultCopyDrop
static java.awt.Cursor	DefaultCopyNoDrop
static java.awt.Cursor	DefaultLinkDrop
static java.awt.Cursor	DefaultLinkNoDrop
static java.awt.Cursor	DefaultMoveDrop
static java.awt.Cursor	DefaultMoveNoDrop

Constructor Summary

Constructors

Constructor and Description
DragSource() Initializes the drag source.

Method Summary

Methods

Modifier and Type	Method and Description
void	addDragSourceListener(DragSourceListener l)
void	addDragSourceMotionListener(DragSourceMotionListener l)
DragGestureRecognizer	createDefaultDragGestureRecognizer(java.awt.Component c, int actions, DragGestureListener dgl)
<T extends DragGestureRecognizer> T	createDragGestureRecognizer(java.lang.Class<T> recognizer, java.awt.Component c, int actions, DragGestureListener dgl)
protected DragSourceContext	createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer peer, DragGestureEvent dge, java.awt.Cursor cursor, java.awt.Image image, java.awt.Point offset, java.awt.datatransfer.Transferable t, DragSourceListener dsl) Creates the DragSourceContext to handle this drag.
static DragSource	getDefaultDragSource() Gets the default drag source.
DragSourceListener[]	getDragSourceListeners()
DragSourceMotionListener[]	getDragSourceMotionListeners()
static int	getDragThreshold() TODO
java.awt.datatransfer.FlavorMap	getFlavorMap()
<T extends java.util.EventListener> T[]	getListeners(java.lang.Class<T> listenerType)
static boolean	isDragImageSupported()
void	removeDragSourceListener(DragSourceListener l)
void	removeDragSourceMotionListener(DragSourceMotionListener l)
void	startDrag(DragGestureEvent trigger, java.awt.Cursor dragCursor, java.awt.Image dragImage, java.awt.Point imageOffset, java.awt.datatransfer.Transferable trans, DragSourceListener dsl) Start a drag, given the DragGestureEvent that initiated the drag.
void	startDrag(DragGestureEvent trigger, java.awt.Cursor dragCursor, java.awt.Image dragImage, java.awt.Point imageOffset, java.awt.datatransfer.Transferable trans, DragSourceListener dsl, java.awt.datatransfer.FlavorMap map) Start a drag, given the DragGestureEvent that initiated the drag.
void	startDrag(DragGestureEvent trigger, java.awt.Cursor dragCursor, java.awt.datatransfer.Transferable trans, DragSourceListener dsl) Start a drag, given the DragGestureEvent that initiated the drag.
void	startDrag(DragGestureEvent trigger, java.awt.Cursor dragCursor, java.awt.datatransfer.Transferable trans, DragSourceListener dsl, java.awt.datatransfer.FlavorMap map) Start a drag, given the DragGestureEvent that initiated the drag.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DefaultCopyDrop

public static final java.awt.Cursor DefaultCopyDrop

DefaultMoveDrop

public static final java.awt.Cursor DefaultMoveDrop

DefaultLinkDrop

public static final java.awt.Cursor DefaultLinkDrop

DefaultCopyNoDrop

public static final java.awt.Cursor DefaultCopyNoDrop

DefaultMoveNoDrop

public static final java.awt.Cursor DefaultMoveNoDrop

DefaultLinkNoDrop

public static final java.awt.Cursor DefaultLinkNoDrop

Constructor Detail

DragSource

public DragSource()

Initializes the drag source.

Throws:

java.awt.HeadlessException - If GraphicsEnvironment.isHeadless() is true.

Method Detail

getDefaultDragSource

public static DragSource getDefaultDragSource()

Gets the default drag source.

Throws:

java.awt.HeadlessException - If GraphicsEnvironment.isHeadless() is true.

isDragImageSupported

public static boolean isDragImageSupported()

startDrag

public void startDrag(DragGestureEvent trigger,
             java.awt.Cursor dragCursor,
             java.awt.Image dragImage,
             java.awt.Point imageOffset,
             java.awt.datatransfer.Transferable trans,
             DragSourceListener dsl,
             java.awt.datatransfer.FlavorMap map)

Start a drag, given the DragGestureEvent that initiated the drag.

Throws:

InvalidDnDOperationException - If the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.

startDrag

public void startDrag(DragGestureEvent trigger,
             java.awt.Cursor dragCursor,
             java.awt.datatransfer.Transferable trans,
             DragSourceListener dsl,
             java.awt.datatransfer.FlavorMap map)

Start a drag, given the DragGestureEvent that initiated the drag.

Throws:

InvalidDnDOperationException - If the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.

startDrag

public void startDrag(DragGestureEvent trigger,
             java.awt.Cursor dragCursor,
             java.awt.Image dragImage,
             java.awt.Point imageOffset,
             java.awt.datatransfer.Transferable trans,
             DragSourceListener dsl)

Start a drag, given the DragGestureEvent that initiated the drag.

Throws:

InvalidDnDOperationException - If the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.

startDrag

public void startDrag(DragGestureEvent trigger,
             java.awt.Cursor dragCursor,
             java.awt.datatransfer.Transferable trans,
             DragSourceListener dsl)

Start a drag, given the DragGestureEvent that initiated the drag.

Throws:

InvalidDnDOperationException - If the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.

createDragSourceContext

protected DragSourceContext createDragSourceContext(java.awt.dnd.peer.DragSourceContextPeer peer,
                                        DragGestureEvent dge,
                                        java.awt.Cursor cursor,
                                        java.awt.Image image,
                                        java.awt.Point offset,
                                        java.awt.datatransfer.Transferable t,
                                        DragSourceListener dsl)

Creates the DragSourceContext to handle this drag.

Throws:

java.lang.IllegalArgumentException

java.lang.NullPointerException - If dscp, dgl, dragImage or t is null.

getFlavorMap

public java.awt.datatransfer.FlavorMap getFlavorMap()

createDragGestureRecognizer

public <T extends DragGestureRecognizer> T createDragGestureRecognizer(java.lang.Class<T> recognizer,
                                                              java.awt.Component c,
                                                              int actions,
                                                              DragGestureListener dgl)

createDefaultDragGestureRecognizer

public DragGestureRecognizer createDefaultDragGestureRecognizer(java.awt.Component c,
                                                       int actions,
                                                       DragGestureListener dgl)

addDragSourceListener

public void addDragSourceListener(DragSourceListener l)

Since:

1.4

removeDragSourceListener

public void removeDragSourceListener(DragSourceListener l)

Since:

1.4

getDragSourceListeners

public DragSourceListener[] getDragSourceListeners()

Since:

1.4

addDragSourceMotionListener

public void addDragSourceMotionListener(DragSourceMotionListener l)

Since:

1.4

removeDragSourceMotionListener

public void removeDragSourceMotionListener(DragSourceMotionListener l)

Since:

1.4

getDragSourceMotionListeners

public DragSourceMotionListener[] getDragSourceMotionListeners()

Since:

1.4

getListeners

public <T extends java.util.EventListener> T[] getListeners(java.lang.Class<T> listenerType)

Since:

1.4

getDragThreshold

public static int getDragThreshold()
                            throws NotImplementedException

TODO

Returns:

TODO

Throws:

NotImplementedException

Since:

1.5