JavaTM 2 Platform
Std. Ed. v1.4.0

java.awt.dnd
Class DropTarget

java.lang.Object
  |
  +--java.awt.dnd.DropTarget
All Implemented Interfaces:
DropTargetListener, EventListener, Serializable

public class DropTarget
extends Object
implements DropTargetListener, Serializable

The DropTarget is associated with a Component when that Component wishes to accept drops during Drag and Drop operations.

Since:
1.2
See Also:
Serialized Form

Nested Class Summary
protected static class DropTarget.DropTargetAutoScroller
          this protected nested class implements autoscrolling
 
Constructor Summary
DropTarget()
          Construct a DropTarget.
DropTarget(Component c, DropTargetListener dtl)
          Construct a DropTarget given the Component to associate itself with, and the DropTargetListener to handle event processing.
DropTarget(Component c, int ops, DropTargetListener dtl)
          Construct 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.
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act)
          Construct 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.
DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)
          Construct 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).
 
Method Summary
 void addDropTargetListener(DropTargetListener dtl)
          Add a new DropTargetListener (UNICAST SOURCE)
 void addNotify(java.awt.peer.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  DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c, Point p)
          create an embedded autoscroller
protected  DropTargetContext createDropTargetContext()
          Create the DropTargetContext associated with this DropTarget.
 void dragEnter(DropTargetDragEvent dtde)
          The DropTarget intercepts dragEnter() notifications before the registered DropTargetListener gets them.
 void dragExit(DropTargetEvent dte)
          The DropTarget intercepts dragExit() notifications before the registered DropTargetListener gets them.
 void dragOver(DropTargetDragEvent dtde)
          The DropTarget intercepts dragOver() notifications before the registered DropTargetListener gets them.
 void drop(DropTargetDropEvent dtde)
          The DropTarget intercepts drop() notifications before the registered DropTargetListener gets them.
 void dropActionChanged(DropTargetDragEvent dtde)
          The DropTarget intercepts dropActionChanged() notifications before the registered DropTargetListener gets them.
 Component getComponent()
          This method returns the Component associated with this DropTarget.
 int getDefaultActions()
          This method returns an int representing the current action(s) supported by this DropTarget.
 DropTargetContext getDropTargetContext()
          This method returns the DropTargetContext associated with this DropTarget.
 FlavorMap getFlavorMap()
          This method returns the FlavorMap associated with this DropTarget
protected  void initializeAutoscrolling(Point p)
          initialize autoscrolling
 boolean isActive()
          This method returns a boolean indicating whether or not this DropTarget is currently active (ready to accept drops).
 void removeDropTargetListener(DropTargetListener dtl)
          Remove the current DropTargetListener (UNICAST SOURCE)
 void removeNotify(java.awt.peer.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.
 void setActive(boolean isActive)
          Set the DropTarget active if true, inactive if false.
 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);
 void setDefaultActions(int ops)
          Sets the default acceptable actions for this DropTarget
 void setFlavorMap(FlavorMap fm)
          This method sets the FlavorMap associated with this DropTarget.
protected  void updateAutoscroll(Point dragCursorLocn)
          update autoscrolling with current cursor locn
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act,
                  FlavorMap fm)
           throws HeadlessException
Construct 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).

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
Throws:
HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also:
GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl,
                  boolean act)
           throws HeadlessException
Construct 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()

DropTarget

public DropTarget()
           throws HeadlessException
Construct a DropTarget.

Throws:
HeadlessException - if GraphicsEnvironment.isHeadless() returns true
See Also:
GraphicsEnvironment.isHeadless()

DropTarget

public DropTarget(Component c,
                  DropTargetListener dtl)
           throws HeadlessException
Construct 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()

DropTarget

public DropTarget(Component c,
                  int ops,
                  DropTargetListener dtl)
           throws HeadlessException
Construct 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()
Method Detail

setComponent

public 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.


getComponent

public Component getComponent()
This method returns the Component associated with this DropTarget.

Returns:
the current Component

setDefaultActions

public void setDefaultActions(int ops)
Sets the default acceptable actions for this DropTarget

Parameters:
ops - the default actions

See Also:
DnDConstants

getDefaultActions

public int getDefaultActions()
This method returns an int representing the current action(s) supported by this DropTarget.

Returns:
the current default actions

setActive

public void setActive(boolean isActive)
Set the DropTarget active if true, inactive if false.

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

isActive

public boolean isActive()
This method returns a boolean indicating whether or not this DropTarget is currently active (ready to accept drops).

Returns:
is the DropTarget active?

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl)
                           throws TooManyListenersException
Add a new DropTargetListener (UNICAST SOURCE)

Parameters:
dtl - The new DropTargetListener

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

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dtl)
Remove the current DropTargetListener (UNICAST SOURCE)

Parameters:
dtl - the DropTargetListener to deregister.

dragEnter

public void dragEnter(DropTargetDragEvent dtde)
The DropTarget intercepts dragEnter() notifications before the registered DropTargetListener gets them.

Specified by:
dragEnter in interface DropTargetListener
Parameters:
dtde - the DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)
The DropTarget intercepts dragOver() notifications before the registered DropTargetListener gets them.

Specified by:
dragOver in interface DropTargetListener
Parameters:
dtde - the DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)
The DropTarget intercepts dropActionChanged() notifications before the registered DropTargetListener gets them.

Specified by:
dropActionChanged in interface DropTargetListener
Parameters:
dtde - the DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)
The DropTarget intercepts dragExit() notifications before the registered DropTargetListener gets them.

Specified by:
dragExit in interface DropTargetListener
Parameters:
dte - the DropTargetEvent

drop

public void drop(DropTargetDropEvent dtde)
The DropTarget intercepts drop() notifications before the registered DropTargetListener gets them.

Specified by:
drop in interface DropTargetListener
Parameters:
dtde - the DropTargetDropEvent

getFlavorMap

public FlavorMap getFlavorMap()
This method returns the FlavorMap associated with this DropTarget

Returns:
the FlavorMap for this DropTarget

setFlavorMap

public void setFlavorMap(FlavorMap fm)
This method sets the FlavorMap associated with this DropTarget.

Parameters:
fm - set the new FlavorMap, or null for default

addNotify

public void addNotify(java.awt.peer.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. Calling this method, other than to notify this DropTarget of the association of the ComponentPeer with the Component may result in a malfunction of the DnD system.

Parameters:
peer - The Peer of the Component we are associated with!

removeNotify

public void removeNotify(java.awt.peer.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. Calling this method, other than to notify this DropTarget of the disassociation of the ComponentPeer from the Component may result in a malfunction of the DnD system.

Parameters:
peer - The Peer of the Component we are being disassociated from!

getDropTargetContext

public DropTargetContext getDropTargetContext()
This method returns the DropTargetContext associated with this DropTarget.

Returns:
the DropTargetContext associated with this DropTarget.

createDropTargetContext

protected DropTargetContext createDropTargetContext()
Create the DropTargetContext associated with this DropTarget. Subclasses may override this method to instantiate their own DropTargetContext subclass. This call is typically *only* called by the platform's DropTargetContextPeer as a drag operation encounters this DropTarget. Accessing the Context while no Drag is current has undefined results.


createDropTargetAutoScroller

protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c,
                                                                         Point p)
create an embedded autoscroller

Parameters:
c - the Component
p - the Point

initializeAutoscrolling

protected void initializeAutoscrolling(Point p)
initialize autoscrolling

Parameters:
p - the Point

updateAutoscroll

protected void updateAutoscroll(Point dragCursorLocn)
update autoscrolling with current cursor locn

Parameters:
dragCursorLocn - the Point

clearAutoscroll

protected void clearAutoscroll()
clear autoscrolling


JavaTM 2 Platform
Std. Ed. v1.4.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.