DragSource JDK 1.6)

public void addDragSourceListener (DragSourceListener dsl)

Adds the specified DragSourceListener to this DragSource to receive drag source events during drag operations intiated with this DragSource.

Adds the specified DragSourceListener to this
DragSource to receive drag source events during drag
operations intiated with this DragSource.
If a null listener is specified, no action is taken and no
exception is thrown.
Parameters:
- dsl - the DragSourceListener to add
Since: 1.4
See Also: DragSource.removeDragSourceListener(java.awt.dnd.DragSourceListener), DragSource.getDragSourceListeners(),

public void addDragSourceMotionListener (DragSourceMotionListener dsml)

Adds the specified DragSourceMotionListener to this DragSource to receive drag motion events during drag operations intiated with this DragSource.

Adds the specified DragSourceMotionListener to this
DragSource to receive drag motion events during drag
operations intiated with this DragSource.
If a null listener is specified, no action is taken and no
exception is thrown.
Parameters:
- dsml - the DragSourceMotionListener to add
Since: 1.4
See Also: DragSource.removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener), DragSource.getDragSourceMotionListeners(),

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

Creates a new DragGestureRecognizer that implements the default abstract subclass of DragGestureRecognizer for this DragSource, and sets the specified Component and DragGestureListener on the newly created object.

Creates a new DragGestureRecognizer that implements the default abstract subclass of DragGestureRecognizer for this DragSource, and sets the specified Component and DragGestureListener on the newly created object. For this DragSource the default is MouseDragGestureRecognizer.

Returns: the new DragGestureRecognizer or null if the Toolkit.createDragGestureRecognizer method has no implementation available for the requested DragGestureRecognizer subclass and returns null
Parameters:
- c - the Component target for the recognizer
- actions - the permitted source actions
- dgl - the DragGestureListener to notify

public T createDragGestureRecognizer (Class< T> recognizerAbstractClass, Component c, int actions, DragGestureListener dgl)

Creates a new DragGestureRecognizer that implements the specified abstract subclass of DragGestureRecognizer, and sets the specified Component and DragGestureListener on the newly created object.

Returns: the new DragGestureRecognizer or null if the Toolkit.createDragGestureRecognizer method has no implementation available for the requested DragGestureRecognizer subclass and returns null
Parameters:
- recognizerAbstractClass - the requested abstract type
- actions - the permitted source drag actions
- c - the Component target
- dgl - the DragGestureListener to notify

protected DragSourceContext createDragSourceContext (DragSourceContextPeer dscp, DragGestureEvent dgl, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable t, DragSourceListener dsl)

Creates the DragSourceContext to handle this drag.

To incorporate a new DragSourceContext subclass, subclass DragSource and override this method.

If dragImage is null, no image is used to represent the drag over feedback for this drag operation, but NullPointerException is not thrown.

If dsl is null, no drag source listener is registered with the created DragSourceContext, but NullPointerException is not thrown.

If dragCursor is null, the default drag cursors are used for this drag operation. NullPointerException is not thrown.
Returns: the DragSourceContext
Parameters:
- dscp - The DragSourceContextPeer for this drag
- dgl - The DragGestureEvent that triggered the drag
- dragCursor - The initial Cursor to display
- dragImage - The Image to drag or null
- imageOffset - The offset of the Image origin from the hotspot of the cursor at the instant of the trigger
- t - The subject data of the drag
- dsl - The DragSourceListener
Throws:
- NullPointerException - if dscp is null
- NullPointerException - if dgl is null
- NullPointerException - if dragImage is not null and imageOffset is null
- NullPointerException - if t is null
- IllegalArgumentException - if the Component associated with the trigger event is null.
- IllegalArgumentException - if the DragSource for the trigger event is null.
- IllegalArgumentException - if the drag action for the trigger event is DnDConstants.ACTION_NONE.
- IllegalArgumentException - if the source actions for the DragGestureRecognizer associated with the trigger event are equal to DnDConstants.ACTION_NONE.

publicstatic DragSource getDefaultDragSource ()

Gets the DragSource object associated with the underlying platform.

Gets the DragSource object associated with
the underlying platform.
Returns: the platform DragSource
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also: GraphicsEnvironment.isHeadless(),

public DragSourceListener getDragSourceListeners ()

Gets all the DragSourceListeners registered with this DragSource.

Gets all the DragSourceListeners
registered with this DragSource.
Returns: all of this DragSource's DragSourceListeners or an empty array if no such listeners are currently registered
Since: 1.4
See Also: DragSource.addDragSourceListener(java.awt.dnd.DragSourceListener), DragSource.removeDragSourceListener(java.awt.dnd.DragSourceListener),

public DragSourceMotionListener getDragSourceMotionListeners ()

Gets all of the DragSourceMotionListeners registered with this DragSource.

Gets all of the DragSourceMotionListeners
registered with this DragSource.
Returns: all of this DragSource's DragSourceMotionListeners or an empty array if no such listeners are currently registered
Since: 1.4
See Also: DragSource.addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener), DragSource.removeDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener),

publicstatic int getDragThreshold ()

Returns the drag gesture motion threshold.

public FlavorMap getFlavorMap ()

This method returns the FlavorMap for this DragSource.

Returns: the FlavorMap for this DragSource

public T getListeners (Class< T> listenerType)

Gets all the objects currently registered as FooListeners upon this DragSource.

Gets all the objects currently registered as
FooListeners upon this DragSource.
FooListeners are registered using the
addFooListener method.
Returns: an array of all objects registered as FooListeners on this DragSource, or an empty array if no such listeners have been added
Parameters:
- listenerType - the type of listeners requested; this parameter should specify an interface that descends from java.util.EventListener
Throws:
- ClassCastException - if listenerType doesn't specify a class or interface that implements java.util.EventListener
Since: 1.4
See Also: DragSource.getDragSourceListeners(), DragSource.getDragSourceMotionListeners(),

publicstatic boolean isDragImageSupported ()

Reports whether or not drag Image support is available on the underlying platform.

Returns: if the Drag Image support is available on this platform

pack-private void processDragDropEnd (DragSourceDropEvent dsde)

This method calls dragDropEnd on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDropEvent.

This method calls dragDropEnd on the
DragSourceListeners registered with this
DragSource, and passes them the specified
DragSourceDropEvent.
Parameters:
- dsde - the DragSourceEvent

pack-private void processDragEnter (DragSourceDragEvent dsde)

This method calls dragEnter on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

This method calls dragEnter on the
DragSourceListeners registered with this
DragSource, and passes them the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceDragEvent

pack-private void processDragExit (DragSourceEvent dse)

This method calls dragExit on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceEvent.

This method calls dragExit on the
DragSourceListeners registered with this
DragSource, and passes them the specified
DragSourceEvent.
Parameters:
- dse - the DragSourceEvent

pack-private void processDragMouseMoved (DragSourceDragEvent dsde)

This method calls dragMouseMoved on the DragSourceMotionListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

This method calls dragMouseMoved on the
DragSourceMotionListeners registered with this
DragSource, and passes them the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceEvent

pack-private void processDragOver (DragSourceDragEvent dsde)

This method calls dragOver on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

This method calls dragOver on the
DragSourceListeners registered with this
DragSource, and passes them the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceDragEvent

pack-private void processDropActionChanged (DragSourceDragEvent dsde)

This method calls dropActionChanged on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

This method calls dropActionChanged on the
DragSourceListeners registered with this
DragSource, and passes them the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceDragEvent

public void removeDragSourceListener (DragSourceListener dsl)

Removes the specified DragSourceListener from this DragSource.

Removes the specified DragSourceListener from this
DragSource.
If a null listener is specified, no action is taken and no
exception is thrown.
If the listener specified by the argument was not previously added to
this DragSource, no action is taken and no exception
is thrown.
Parameters:
- dsl - the DragSourceListener to remove
Since: 1.4
See Also: DragSource.addDragSourceListener(java.awt.dnd.DragSourceListener), DragSource.getDragSourceListeners(),

public void removeDragSourceMotionListener (DragSourceMotionListener dsml)

Removes the specified DragSourceMotionListener from this DragSource.

Removes the specified DragSourceMotionListener from this
DragSource.
If a null listener is specified, no action is taken and no
exception is thrown.
If the listener specified by the argument was not previously added to
this DragSource, no action is taken and no exception
is thrown.
Parameters:
- dsml - the DragSourceMotionListener to remove
Since: 1.4
See Also: DragSource.addDragSourceMotionListener(java.awt.dnd.DragSourceMotionListener), DragSource.getDragSourceMotionListeners(),

public void startDrag (DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point dragOffset, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Image to drag, the offset of the Image origin from the hotspot of the Cursor at the instant of the trigger, the subject data of the drag, and the DragSourceListener.

Parameters:
- trigger - the DragGestureEvent that initiated the drag
- dragCursor - the initial Cursor or null for defaults
- dragImage - the Image to drag or null
- dragOffset - the offset of the Image origin from the hotspot of the Cursor at the instant of the trigger
- transferable - the subject data of the drag
- dsl - the DragSourceListener

Throws:
- java.awt.dnd.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

public void startDrag (DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) throws InvalidDnDOperationException

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Image to drag, the offset of the Image origin from the hotspot of the Cursor at the instant of the trigger, the Transferable subject data of the drag, the DragSourceListener, and the FlavorMap.

Parameters:
- trigger - the DragGestureEvent that initiated the drag
- dragCursor - the initial Cursor or null for defaults
- dragImage - the image to drag or null,
- imageOffset - the offset of the Image origin from the hotspot of the Cursor at the instant of the trigger
- transferable - the subject data of the drag
- dsl - the DragSourceListener
- flavorMap - the FlavorMap to use, or null

Throws:
- java.awt.dnd.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

public void startDrag (DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Transferable subject data of the drag, and the DragSourceListener.

Parameters:
- trigger - the DragGestureEvent that initiated the drag
- dragCursor - the initial Cursor or null for defaults
- transferable - the subject data of the drag
- dsl - the DragSourceListener

Throws:
- java.awt.dnd.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

public void startDrag (DragGestureEvent trigger, Cursor dragCursor, Transferable transferable, DragSourceListener dsl, FlavorMap flavorMap) throws InvalidDnDOperationException

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Transferable subject data of the drag, the DragSourceListener, and the FlavorMap.

Parameters:
- trigger - the DragGestureEvent that initiated the drag
- dragCursor - the initial Cursor or null for defaults
- transferable - the subject data of the drag
- dsl - the DragSourceListener
- flavorMap - the FlavorMap to use or null

Throws:
- java.awt.dnd.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