Also see:

setDefaultActions
getDefaultActions
serial:

serial:

 public DropTarget() throws HeadlessException 
{
        this(null, DnDConstants.ACTION_COPY_OR_MOVE, null, true, null);
}

Creates a DropTarget.

Throws:

HeadlessException - if GraphicsEnvironment.isHeadless() returns true

Also see:

java.awt.GraphicsEnvironment#isHeadless
exception: HeadlessException - if GraphicsEnvironment.isHeadless() returns true

 public DropTarget(Component c,
    DropTargetListener dtl) throws HeadlessException 
{
        this(c, DnDConstants.ACTION_COPY_OR_MOVE, dtl, true, null);
}

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

Also see:

java.awt.GraphicsEnvironment#isHeadless
exception: HeadlessException - if GraphicsEnvironment.isHeadless() returns true

 public DropTarget(Component c,
    int ops,
    DropTargetListener dtl) throws HeadlessException 
{
        this(c, ops, dtl, true);
}

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

Also see:

java.awt.GraphicsEnvironment#isHeadless
exception: HeadlessException - if GraphicsEnvironment.isHeadless() returns true

 public DropTarget(Component c,
    int ops,
    DropTargetListener dtl,
    boolean act) throws HeadlessException 
{
        this(c, ops, dtl, act, null);
}

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

Also see:

java.awt.GraphicsEnvironment#isHeadless
exception: HeadlessException - if GraphicsEnvironment.isHeadless() returns true

 public DropTarget(Component c,
    int ops,
    DropTargetListener dtl,
    boolean act,
    FlavorMap fm) throws HeadlessException 
{
                                                                                                                                                                    
        if (GraphicsEnvironment.isHeadless()) {
            throw new HeadlessException();
        }
        component = c;
        setDefaultActions(ops);
        if (dtl != null) try {
            addDropTargetListener(dtl);
        } catch (TooManyListenersException tmle) {
            // do nothing!
        }
        if (c != null) {
            c.setDropTarget(this);
            setActive(act);
        }
        if (fm != null) {
            flavorMap = fm;
        } else {
            flavorMap = SystemFlavorMap.getDefaultFlavorMap();
        }
}

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

Also see:

java.awt.GraphicsEnvironment#isHeadless
exception: HeadlessException - if GraphicsEnvironment.isHeadless() returns true

 public synchronized  void addDropTargetListener(DropTargetListener dtl) throws TooManyListenersException 
{
        if (dtl == null) return;
        if (equals(dtl)) throw new IllegalArgumentException("DropTarget may not be its own Listener");
        if (dtListener == null)
            dtListener = dtl;
        else
            throw new TooManyListenersException();
}

Adds a new DropTargetListener (UNICAST SOURCE).

 public  void addNotify(ComponentPeer peer) 
{
        if (peer == componentPeer) return;
        componentPeer = peer;
        for (Component c = component;
             c != null && peer instanceof LightweightPeer; c = c.getParent()) {
            peer = c.getPeer();
        }
        if (peer instanceof DropTargetPeer) {
            nativePeer = peer;
            ((DropTargetPeer)peer).addDropTarget(this);
        } else {
            nativePeer = null;
        }
}

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.

 protected  void clearAutoscroll() 
{
        if (autoScroller != null) {
            autoScroller.stop();
            autoScroller = null;
        }
}

clear autoscrolling

 protected DropTarget.DropTargetAutoScroller createDropTargetAutoScroller(Component c,
    Point p) 
{
    
        return new DropTargetAutoScroller(c, p);
}

/ /** create an embedded autoscroller

 protected DropTargetContext createDropTargetContext() 
{
        return new DropTargetContext(this);
}

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

  void doSetDefaultActions(int ops) 
{
        actions = ops;
}

 public synchronized  void dragEnter(DropTargetDragEvent dtde) 
{
        if (!active) return;
        if (dtListener != null) {
            dtListener.dragEnter(dtde);
        } else
            dtde.getDropTargetContext().setTargetActions(DnDConstants.ACTION_NONE);
        initializeAutoscrolling(dtde.getLocation());
}

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

 public synchronized  void dragExit(DropTargetEvent dte) 
{
        if (!active) return;
        if (dtListener != null && active) dtListener.dragExit(dte);
        clearAutoscroll();
}

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.

 public synchronized  void dragOver(DropTargetDragEvent dtde) 
{
        if (!active) return;
        if (dtListener != null && active) dtListener.dragOver(dtde);
        updateAutoscroll(dtde.getLocation());
}

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

 public synchronized  void drop(DropTargetDropEvent dtde) 
{
        clearAutoscroll();
        if (dtListener != null && active)
            dtListener.drop(dtde);
        else { // we should'nt get here ...
            dtde.rejectDrop();
        }
}

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

 public synchronized  void dropActionChanged(DropTargetDragEvent dtde) 
{
        if (!active) return;
        if (dtListener != null) dtListener.dropActionChanged(dtde);
        updateAutoscroll(dtde.getLocation());
}

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

 public synchronized Component getComponent() 
{
        return component;
}

Gets the Component associated with this DropTarget.

 public int getDefaultActions() 
{
        return actions;
}

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

 public DropTargetContext getDropTargetContext() 
{
        return dropTargetContext;
}

Gets the DropTargetContext associated with this DropTarget.

 public FlavorMap getFlavorMap() 
{
 return flavorMap;
}

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

 protected  void initializeAutoscrolling(Point p) 
{
        if (component == null || !(component instanceof Autoscroll)) return;
        autoScroller = createDropTargetAutoScroller(component, p);
}

initialize autoscrolling

 public boolean isActive() 
{
        return active;
}

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

 public synchronized  void removeDropTargetListener(DropTargetListener dtl) 
{
        if (dtl != null && dtListener != null) {
            if(dtListener.equals(dtl))
                dtListener = null;
            else
                throw new IllegalArgumentException("listener mismatch");
        }
}

Removes the current DropTargetListener (UNICAST SOURCE).

 public  void removeNotify(ComponentPeer peer) 
{
        if (nativePeer != null)
            ((DropTargetPeer)nativePeer).removeDropTarget(this);
        componentPeer = nativePeer = null;
}

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.

 public synchronized  void setActive(boolean isActive) 
{
        if (isActive != active) {
            active = isActive;
        }
        if (!active) clearAutoscroll();
}

Sets the DropTarget active if true, inactive if false.

 public synchronized  void setComponent(Component c) 
{
        if (component == c || component != null && component.equals(c))
            return;
        Component     old;
        ComponentPeer oldPeer = null;
        if ((old = component) != null) {
            clearAutoscroll();
            component = null;
            if (componentPeer != null) {
                oldPeer = componentPeer;
                removeNotify(componentPeer);
            }
            old.setDropTarget(null);
        }
        if ((component = c) != null) try {
            c.setDropTarget(this);
        } catch (Exception e) { // undo the change
            if (old != null) {
                old.setDropTarget(this);
                addNotify(oldPeer);
            }
        }
}

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.

 public  void setDefaultActions(int ops) 
{
        getDropTargetContext().setTargetActions(ops & (DnDConstants.ACTION_COPY_OR_MOVE | DnDConstants.ACTION_REFERENCE));
}

Sets the default acceptable actions for this DropTarget

 public  void setFlavorMap(FlavorMap fm) 
{
        flavorMap = fm == null ? SystemFlavorMap.getDefaultFlavorMap() : fm;
}

Sets the FlavorMap associated with this DropTarget.

 protected  void updateAutoscroll(Point dragCursorLocn) 
{
        if (autoScroller != null) autoScroller.updateLocation(dragCursorLocn);
}

update autoscrolling with current cursor locn