DropTarget JDK 1.6)

Constructors

public DropTarget () throws HeadlessException

Creates a DropTarget.

Creates a DropTarget.
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also: GraphicsEnvironment.isHeadless(),

public DropTarget (Component c, DropTargetListener dtl) throws HeadlessException

Creates a DropTarget given the Component to associate itself with, and the DropTargetListener to handle event processing.

The Component will receive drops only if it is enabled.
Parameters:
- c - The Component with which this DropTarget is associated
- dtl - The DropTargetListener for this DropTarget
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also: GraphicsEnvironment.isHeadless(),

public DropTarget (Component c, int ops, DropTargetListener dtl) throws HeadlessException

Creates a DropTarget given the Component to associate itself with, an int representing the default acceptable action(s) to support, and a DropTargetListener to handle event processing.

The Component will receive drops only if it is enabled.
Parameters:
- c - The Component with which this DropTarget is associated
- ops - The default acceptable actions for this DropTarget
- dtl - The DropTargetListener for this DropTarget
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also: GraphicsEnvironment.isHeadless(),

public DropTarget (Component c, int ops, DropTargetListener dtl, boolean act) throws HeadlessException

Creates a DropTarget given the Component to associate itself with, an int representing the default acceptable action(s) to support, a DropTargetListener to handle event processing, and a boolean indicating if the DropTarget is currently accepting drops.

The Component will receive drops only if it is enabled.
Parameters:
- c - The Component with which this DropTarget is associated
- ops - The default acceptable actions for this DropTarget
- dtl - The DropTargetListener for this DropTarget
- act - Is the DropTarget accepting drops.
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also: GraphicsEnvironment.isHeadless(),

public DropTarget (Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm) throws HeadlessException

Creates a new DropTarget given the Component to associate itself with, an int representing the default acceptable action(s) to support, a DropTargetListener to handle event processing, a boolean indicating if the DropTarget is currently accepting drops, and a FlavorMap to use (or null for the default FlavorMap).

The Component will receive drops only if it is enabled.
Parameters:
- c - The Component with which this DropTarget is associated
- ops - The default acceptable actions for this DropTarget
- dtl - The DropTargetListener for this DropTarget
- act - Is the DropTarget accepting drops.
- fm - The FlavorMap to use, or null for the default FlavorMap
Throws:
- HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also: GraphicsEnvironment.isHeadless(),

Methods

Hide/Show inherited methods

publicsynchronized void addDropTargetListener (DropTargetListener dtl) throws TooManyListenersException

Adds a new DropTargetListener (UNICAST SOURCE).

Parameters:
- dtl - The new DropTargetListener

Throws:
- TooManyListenersException - if a DropTargetListener is already added to this DropTarget.

public void addNotify (ComponentPeer peer)

Notify the DropTarget that it has been associated with a Component This method is usually called from java.awt.Component.addNotify() of the Component associated with this DropTarget to notify the DropTarget that a ComponentPeer has been associated with that Component.

protected void clearAutoscroll ()

clear autoscrolling

protected DropTargetAutoScroller createDropTargetAutoScroller (Component c, Point p)

create an embedded autoscroller

protected DropTargetContext createDropTargetContext ()

Creates the DropTargetContext associated with this DropTarget.

pack-private void doSetDefaultActions (int ops)

publicsynchronized void dragEnter (DropTargetDragEvent dtde) [Specified in DropTargetListener]

Calls dragEnter on the registered DropTargetListener and passes it the specified DropTargetDragEvent.

Calls dragEnter on the registered
DropTargetListener and passes it
the specified DropTargetDragEvent.
Has no effect if this DropTarget
is not active.
Parameters:
- dtde - the DropTargetDragEvent
Throws:
- NullPointerException - if this DropTarget is active and dtde is null
See Also: DropTarget.isActive(),

publicsynchronized void dragExit (DropTargetEvent dte) [Specified in DropTargetListener]

Calls dragExit on the registered DropTargetListener and passes it the specified DropTargetEvent.

Calls dragExit on the registered DropTargetListener and passes it the specified DropTargetEvent. Has no effect if this DropTarget is not active.

This method itself does not throw any exception for null parameter but for exceptions thrown by the respective method of the listener.
Parameters:
- dte - the DropTargetEvent
See Also: DropTarget.isActive(),

publicsynchronized void dragOver (DropTargetDragEvent dtde) [Specified in DropTargetListener]

Calls dragOver on the registered DropTargetListener and passes it the specified DropTargetDragEvent.

Calls dragOver on the registered
DropTargetListener and passes it
the specified DropTargetDragEvent.
Has no effect if this DropTarget
is not active.
Parameters:
- dtde - the DropTargetDragEvent
Throws:
- NullPointerException - if this DropTarget is active and dtde is null
See Also: DropTarget.isActive(),

publicsynchronized void drop (DropTargetDropEvent dtde) [Specified in DropTargetListener]

Calls drop on the registered DropTargetListener and passes it the specified DropTargetDropEvent if this DropTarget is active.

Calls drop on the registered
DropTargetListener and passes it
the specified DropTargetDropEvent
if this DropTarget is active.
Parameters:
- dtde - the DropTargetDropEvent
Throws:
- NullPointerException - if dtde is null and at least one of the following is true: this DropTarget is not active, or there is no a DropTargetListener registered.
See Also: DropTarget.isActive(),

publicsynchronized void dropActionChanged (DropTargetDragEvent dtde) [Specified in DropTargetListener]

Calls dropActionChanged on the registered DropTargetListener and passes it the specified DropTargetDragEvent.

Calls dropActionChanged on the registered
DropTargetListener and passes it
the specified DropTargetDragEvent.
Has no effect if this DropTarget
is not active.
Parameters:
- dtde - the DropTargetDragEvent
Throws:
- NullPointerException - if this DropTarget is active and dtde is null
See Also: DropTarget.isActive(),

publicsynchronized Component getComponent ()

Gets the Component associated with this DropTarget.

Returns: the current Component

public int getDefaultActions ()

Gets an int representing the current action(s) supported by this DropTarget.

Returns: the current default actions

public DropTargetContext getDropTargetContext ()

Gets the DropTargetContext associated with this DropTarget.

Returns: the DropTargetContext associated with this DropTarget.

public FlavorMap getFlavorMap ()

Gets the FlavorMap associated with this DropTarget.

Gets the FlavorMap associated with this DropTarget. If no FlavorMap has been set for this DropTarget, it is associated with the default FlavorMap.

Returns: the FlavorMap for this DropTarget

protected void initializeAutoscrolling (Point p)

initialize autoscrolling

public boolean isActive ()

Reports whether or not this DropTarget is currently active (ready to accept drops).

Returns: true if active, false if not

publicsynchronized void removeDropTargetListener (DropTargetListener dtl)

Removes the current DropTargetListener (UNICAST SOURCE).

Parameters:
- dtl - the DropTargetListener to deregister.

public void removeNotify (ComponentPeer peer)

Notify the DropTarget that it has been disassociated from a Component This method is usually called from java.awt.Component.removeNotify() of the Component associated with this DropTarget to notify the DropTarget that a ComponentPeer has been disassociated with that Component.

publicsynchronized void setActive (boolean isActive)

Sets the DropTarget active if true, inactive if false.

Parameters:
- isActive - sets the DropTarget (in)active.

publicsynchronized void setComponent (Component c)

Note: this interface is required to permit the safe association of a DropTarget with a Component in one of two ways, either: component.setDropTarget(droptarget); or droptarget.setComponent(component);

The Component will receive drops only if it is enabled.
Parameters:
- c - The new Component this DropTarget is to be associated with.

public void setDefaultActions (int ops)

Sets the default acceptable actions for this DropTarget

Parameters:
- ops - the default actions

See Also: DnDConstants,

public void setFlavorMap (FlavorMap fm)

Sets the FlavorMap associated with this DropTarget.

Parameters:
- fm - the new FlavorMap, or null to associate the default FlavorMap with this DropTarget.

protected void updateAutoscroll (Point dragCursorLocn)

update autoscrolling with current cursor locn