Contents | Package | Class | Tree | Deprecated | Index | Help Java 1.2 Beta 3
PREV | NEXT SHOW LISTS | HIDE LISTS

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

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

Method Summary
void  addDropTargetListener(DropTargetListener dte)
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.
void  clearAutoscroll()
clear autoscrolling
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()
 
void  initializeAutoscrolling(Point p)
initialize autoscrolling
boolean  isActive()
 
void  removeDropTargetListener(DropTargetListener dte)
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  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)
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() throws SecurityException
Construct a DropTarget

DropTarget

public DropTarget(Component c,
                  DropTargetListener dtl) throws SecurityException
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) throws SecurityException
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 dte) throws TooManyListenersException
Add a new DropTargetListener (UNICAST SOURCE)
Parameters:
dte - The new DropTargetListener

removeDropTargetListener

public void removeDropTargetListener(DropTargetListener dte)
Remove the current DropTargetListener (UNICAST SOURCE)
Parameters:
dte - the DropTargetListener to deregister.

dragEnter

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

dragOver

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

dropActionChanged

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

dragExit

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

drop

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

getFlavorMap

public FlavorMap getFlavorMap()
Returns:
the FlavorMap for this DropTarget

addNotify

public void addNotify(java.awt.peer.ComponentPeer peer) throws SecurityException
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.
Parameters:
owner - the owner of the DropTargetContext

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

Contents | Package | Class | Tree | Deprecated | Index | Help Java 1.2 Beta 3
PREV | NEXT SHOW LISTS | HIDE LISTS

Submit a bug or feature
Submit comments/suggestions about new javadoc look.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.