DragSourceContext JDK 1.6)

Constructors

public DragSourceContext (DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)

Called from DragSource, this constructor creates a new
DragSourceContext given the
DragSourceContextPeer for this Drag, the
DragGestureEvent that triggered the Drag, the initial
Cursor to use for the Drag, an (optional)
Image to display while the Drag is taking place, the offset
of the Image origin from the hotspot at the instant of the
triggering event, the Transferable subject data, and the
DragSourceListener to use during the Drag and Drop
operation.

If DragSourceContextPeer is null
NullPointerException is thrown.

If DragGestureEvent is null
NullPointerException is thrown.

If Cursor is null no exception is thrown and
the default drag cursor behavior is activated for this drag operation.

If Image is null no exception is thrown.

If Image is not null and the offset is
null NullPointerException is thrown.

If Transferable is null
NullPointerException is thrown.

If DragSourceListener is null no exception
is thrown.
Parameters:
- dscp - the DragSourceContextPeer for this drag
- trigger - the triggering event
- dragCursor - the initial Cursor
- dragImage - the Image to drag (or null)
- offset - the offset of the image origin from the hotspot at the instant of the triggering event
- t - the Transferable
- dsl - the DragSourceListener
Throws:
- 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.
- NullPointerException - if dscp, trigger, or t are null, or if dragImage is non-null and offset is null

Methods

Hide/Show inherited methods

publicsynchronized void addDragSourceListener (DragSourceListener dsl) throws TooManyListenersException

Add a DragSourceListener to this DragSourceContext if one has not already been added.

Add a DragSourceListener to this DragSourceContext if one has not already been added. If a DragSourceListener already exists, this method throws a TooManyListenersException.

Parameters:
- dsl - the DragSourceListener to add. Note that while null is not prohibited, it is not acceptable as a parameter.

Throws:
- TooManyListenersException - if a DragSourceListener has already been added

public void dragDropEnd (DragSourceDropEvent dsde) [Specified in DragSourceListener]

Calls dragDropEnd on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDropEvent.

Calls dragDropEnd on the
DragSourceListeners registered with this
DragSourceContext and with the associated
DragSource, and passes them the specified
DragSourceDropEvent.
Parameters:
- dsde - the DragSourceDropEvent

public void dragEnter (DragSourceDragEvent dsde) [Specified in DragSourceListener]

Calls dragEnter on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDragEvent.

Calls dragEnter on the
DragSourceListeners registered with this
DragSourceContext and with the associated
DragSource, and passes them the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceDragEvent

public void dragExit (DragSourceEvent dse) [Specified in DragSourceListener]

Calls dragExit on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceEvent.

Calls dragExit on the
DragSourceListeners registered with this
DragSourceContext and with the associated
DragSource, and passes them the specified
DragSourceEvent.
Parameters:
- dse - the DragSourceEvent

public void dragMouseMoved (DragSourceDragEvent dsde) [Specified in DragSourceMotionListener]

Calls dragMouseMoved on the DragSourceMotionListeners registered with the DragSource associated with this DragSourceContext, and them passes the specified DragSourceDragEvent.

Calls dragMouseMoved on the
DragSourceMotionListeners registered with the
DragSource associated with this
DragSourceContext, and them passes the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceDragEvent
Since: 1.4

public void dragOver (DragSourceDragEvent dsde) [Specified in DragSourceListener]

Calls dragOver on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDragEvent.

Calls dragOver on the
DragSourceListeners registered with this
DragSourceContext and with the associated
DragSource, and passes them the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceDragEvent

public void dropActionChanged (DragSourceDragEvent dsde) [Specified in DragSourceListener]

Calls dropActionChanged on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDragEvent.

Calls dropActionChanged on the
DragSourceListeners registered with this
DragSourceContext and with the associated
DragSource, and passes them the specified
DragSourceDragEvent.
Parameters:
- dsde - the DragSourceDragEvent

public Component getComponent ()

Returns the Component associated with this DragSourceContext.

Returns the Component associated with this
DragSourceContext.
Returns: the Component that started the drag

public Cursor getCursor ()

Returns the current drag Cursor.

Returns: the current drag Cursor

public DragSource getDragSource ()

Returns the DragSource that instantiated this DragSourceContext.

Returns the DragSource
that instantiated this DragSourceContext.
Returns: the DragSource that instantiated this DragSourceContext

public int getSourceActions ()

Returns a bitwise mask of DnDConstants that represent the set of drop actions supported by the drag source for the drag operation associated with this DragSourceContext.

Returns a bitwise mask of DnDConstants that
represent the set of drop actions supported by the drag source for the
drag operation associated with this DragSourceContext.
Returns: the drop actions supported by the drag source

public Transferable getTransferable ()

Returns the Transferable associated with this DragSourceContext.

Returns the Transferable associated with
this DragSourceContext.
Returns: the Transferable

public DragGestureEvent getTrigger ()

Returns the DragGestureEvent that initially triggered the drag.

Returns the DragGestureEvent
that initially triggered the drag.
Returns: the Event that triggered the drag

publicsynchronized void removeDragSourceListener (DragSourceListener dsl)

Removes the specified DragSourceListener from this DragSourceContext.

Removes the specified DragSourceListener
from this DragSourceContext.
Parameters:
- dsl - the DragSourceListener to remove; note that while null is not prohibited, it is not acceptable as a parameter

publicsynchronized void setCursor (Cursor c)

Sets the cursor for this drag operation to the specified Cursor.

Sets the cursor for this drag operation to the specified
Cursor. If the specified Cursor
is null, the default drag cursor behavior is
activated for this drag operation, otherwise it is deactivated.
Parameters:
- c - the Cursor to display, or null to activate the default drag cursor behavior

public void transferablesFlavorsChanged ()

Notifies the peer that the Transferable's DataFlavors have changed.

protectedsynchronized void updateCurrentCursor (int sourceAct, int targetAct, int status)

If the default drag cursor behavior is active, this method
sets the default drag cursor for the specified actions
supported by the drag source, the drop target action,
and status, otherwise this method does nothing.
Parameters:
- sourceAct - the actions supported by the drag source
- targetAct - the drop target action
- status - one of the fields DEFAULT, ENTER, OVER, CHANGED