java.awt.dnd
Class DropTarget

java.lang.Object
  |
  +--java.awt.dnd.DropTarget

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:

JDK1.2

See Also:

Serialized Form

Inner 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

DropTarget(Component c, int ops, DropTargetListener dtl)
Construct a DropTarget

DropTarget(Component c, int ops, DropTargetListener dtl, boolean act)
Construct a DropTarget

DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)
Construct a DropTarget

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()
int	getDefaultActions()
DropTargetContext	getDropTargetContext()
FlavorMap	getFlavorMap()
protected void	initializeAutoscrolling(Point p) initialize autoscrolling
boolean	isActive()
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 (in)active.
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 caller must have AWTPermission.setDropTarget to succeed.
void	setDefaultActions(int ops) Sets the default acceptable actions for this DropTarget
void	setFlavorMap(FlavorMap fm)
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)

Construct a DropTarget

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

DropTarget

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

Construct a DropTarget

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.

DropTarget

public DropTarget()

Construct a DropTarget

DropTarget

public DropTarget(Component c,
                  DropTargetListener dtl)

Construct a DropTarget

Parameters:

c - The Component with which this DropTarget is associated

dtl - The DropTargetListener for this DropTarget

DropTarget

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

Construct a DropTarget

Parameters:

c - The Component with which this DropTarget is associated

ops - The default acceptable actions for this DropTarget

dtl - The DropTargetListener for this DropTarget

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 caller must have AWTPermission.setDropTarget to succeed.

Parameters:

c - The new Component this DropTarget is to be associated with.

getComponent

public Component getComponent()

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()

Returns:

the current default actions

setActive

public void setActive(boolean isActive)

set the DropTarget (in)active.

Parameters:

isActive -

isActive

public boolean isActive()

Returns:

is the DropTarget active?

addDropTargetListener

public void addDropTargetListener(DropTargetListener dtl)
                           throws TooManyListenersException

Add a new DropTargetListener (UNICAST SOURCE)

Parameters:

dtl - The new DropTargetListener

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

dragOver

public void dragOver(DropTargetDragEvent dtde)

The DropTarget intercepts dragOver() notifications before the registered DropTargetListener gets them.

Specified by:

dragOver in interface DropTargetListener

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

The DropTarget intercepts dropActionChanged() notifications before the registered DropTargetListener gets them.

Specified by:

dropActionChanged in interface DropTargetListener

dragExit

public void dragExit(DropTargetEvent dte)

The DropTarget intercepts dragExit() notifications before the registered DropTargetListener gets them.

Specified by:

dragExit in interface DropTargetListener

drop

public void drop(DropTargetDropEvent dtde)

The DropTarget intercepts drop() notifications before the registered DropTargetListener gets them.

Specified by:

drop in interface DropTargetListener

getFlavorMap

public FlavorMap getFlavorMap()

Returns:

the FlavorMap for this DropTarget

setFlavorMap

public void setFlavorMap(FlavorMap fm)

Parameters:

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 froe!

getDropTargetContext

public DropTargetContext getDropTargetContext()

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

initializeAutoscrolling

protected void initializeAutoscrolling(Point p)

initialize autoscrolling

updateAutoscroll

protected void updateAutoscroll(Point dragCursorLocn)

update autoscrolling with current cursor locn

clearAutoscroll

protected void clearAutoscroll()

clear autoscrolling