Also see:

java.awt.GraphicsEnvironment#isHeadless

Also see:

java.awt.GraphicsEnvironment#isHeadless

Also see:

java.awt.GraphicsEnvironment#isHeadless

Also see:

java.awt.GraphicsEnvironment#isHeadless

Also see:

java.awt.GraphicsEnvironment#isHeadless

Also see:

java.awt.GraphicsEnvironment#isHeadless

 public DragSource() throws HeadlessException 
{
        if (GraphicsEnvironment.isHeadless()) {
            throw new HeadlessException();
        }
}

Creates a new DragSource.

Throws:

HeadlessException - if GraphicsEnvironment.isHeadless() returns true

Also see:

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

 public  void addDragSourceListener(DragSourceListener dsl) 
{
        if (dsl != null) {
            synchronized (this) {
                listener = DnDEventMulticaster.add(listener, dsl);
            }
        }
}

Adds the specified DragSourceListener to this DragSource to receive drag source events during drag operations intiated with this DragSource. If a null listener is specified, no action is taken and no exception is thrown.

 public  void addDragSourceMotionListener(DragSourceMotionListener dsml) 
{
        if (dsml != null) {
            synchronized (this) {
                motionListener = DnDEventMulticaster.add(motionListener, dsml);
            }
        }
}

Adds the specified DragSourceMotionListener to this DragSource to receive drag motion events during drag operations intiated with this DragSource. If a null listener is specified, no action is taken and no exception is thrown.

 public DragGestureRecognizer createDefaultDragGestureRecognizer(Component c,
    int actions,
    DragGestureListener dgl) 
{
        return Toolkit.getDefaultToolkit().createDragGestureRecognizer(MouseDragGestureRecognizer.class, this, c, actions, dgl);
}

Creates a new DragGestureRecognizer that implements the default abstract subclass of DragGestureRecognizer for this DragSource, and sets the specified Component and DragGestureListener on the newly created object. For this DragSource the default is MouseDragGestureRecognizer.

 public T createDragGestureRecognizer(Class recognizerAbstractClass,
    Component c,
    int actions,
    DragGestureListener dgl) 
{
        return Toolkit.getDefaultToolkit().createDragGestureRecognizer(recognizerAbstractClass, this, c, actions, dgl);
}

Creates a new DragGestureRecognizer that implements the specified abstract subclass of DragGestureRecognizer, and sets the specified Component and DragGestureListener on the newly created object.

 protected DragSourceContext createDragSourceContext(DragSourceContextPeer dscp,
    DragGestureEvent dgl,
    Cursor dragCursor,
    Image dragImage,
    Point imageOffset,
    Transferable t,
    DragSourceListener dsl) 
{
        return new DragSourceContext(dscp, dgl, dragCursor, dragImage, imageOffset, t, dsl);
}

Creates the {@code DragSourceContext} to handle the current drag operation.

To incorporate a new DragSourceContext subclass, subclass DragSource and override this method.

If dragImage is null, no image is used to represent the drag over feedback for this drag operation, but NullPointerException is not thrown.

If dsl is null, no drag source listener is registered with the created DragSourceContext, but NullPointerException is not thrown.

 public static DragSource getDefaultDragSource() 
{
                                         
        if (GraphicsEnvironment.isHeadless()) {
            throw new HeadlessException();
        } else {
            return dflt;
        }
}

Gets the DragSource object associated with the underlying platform.

 public DragSourceListener[] getDragSourceListeners() 
{
        return (DragSourceListener[])getListeners(DragSourceListener.class);
}

Gets all the DragSourceListeners registered with this DragSource.

 public DragSourceMotionListener[] getDragSourceMotionListeners() 
{
        return (DragSourceMotionListener[])
            getListeners(DragSourceMotionListener.class);
}

Gets all of the DragSourceMotionListeners registered with this DragSource.

 public static int getDragThreshold() 
{
        int ts = ((Integer)AccessController.doPrivileged(
                new GetIntegerAction("awt.dnd.drag.threshold", 0))).intValue();
        if (ts  > 0) {
            return ts;
        } else {
            Integer td = (Integer)Toolkit.getDefaultToolkit().
                    getDesktopProperty("DnD.gestureMotionThreshold");
            if (td != null) {
                return td.intValue();
            }
        }
        return 5;
}

Returns the drag gesture motion threshold. The drag gesture motion threshold defines the recommended behavior for MouseDragGestureRecognizer s.

If the system property awt.dnd.drag.threshold is set to a positive integer, this method returns the value of the system property; otherwise if a pertinent desktop property is available and supported by the implementation of the Java platform, this method returns the value of that property; otherwise this method returns some default value. The pertinent desktop property can be queried using java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold").

 public FlavorMap getFlavorMap() 
{
 return flavorMap;
}

This method returns the FlavorMap for this DragSource.

 public T[] getListeners(Class listenerType) 
{
        EventListener l = null;
        if (listenerType == DragSourceListener.class) {
            l = listener;
        } else if (listenerType == DragSourceMotionListener.class) {
            l = motionListener;
        }
        return DnDEventMulticaster.getListeners(l, listenerType);
}

Gets all the objects currently registered as FooListeners upon this DragSource. FooListeners are registered using the addFooListener method.

 public static boolean isDragImageSupported() 
{
        Toolkit t = Toolkit.getDefaultToolkit();
        Boolean supported;
        try {
            supported = (Boolean)Toolkit.getDefaultToolkit().getDesktopProperty("DnD.isDragImageSupported");
            return supported.booleanValue();
        } catch (Exception e) {
            return false;
        }
}

Reports whether or not drag Image support is available on the underlying platform.

  void processDragDropEnd(DragSourceDropEvent dsde) 
{
        DragSourceListener dsl = listener;
        if (dsl != null) {
            dsl.dragDropEnd(dsde);
        }
}

This method calls dragDropEnd on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDropEvent.

  void processDragEnter(DragSourceDragEvent dsde) 
{
        DragSourceListener dsl = listener;
        if (dsl != null) {
            dsl.dragEnter(dsde);
        }
}

This method calls dragEnter on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

  void processDragExit(DragSourceEvent dse) 
{
        DragSourceListener dsl = listener;
        if (dsl != null) {
            dsl.dragExit(dse);
        }
}

This method calls dragExit on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceEvent.

  void processDragMouseMoved(DragSourceDragEvent dsde) 
{
        DragSourceMotionListener dsml = motionListener;
        if (dsml != null) {
            dsml.dragMouseMoved(dsde);
        }
}

This method calls dragMouseMoved on the DragSourceMotionListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

  void processDragOver(DragSourceDragEvent dsde) 
{
        DragSourceListener dsl = listener;
        if (dsl != null) {
            dsl.dragOver(dsde);
        }
}

This method calls dragOver on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

  void processDropActionChanged(DragSourceDragEvent dsde) 
{
        DragSourceListener dsl = listener;
        if (dsl != null) {
            dsl.dropActionChanged(dsde);
        }
}

This method calls dropActionChanged on the DragSourceListeners registered with this DragSource, and passes them the specified DragSourceDragEvent.

 public  void removeDragSourceListener(DragSourceListener dsl) 
{
        if (dsl != null) {
            synchronized (this) {
                listener = DnDEventMulticaster.remove(listener, dsl);
            }
        }
}

Removes the specified DragSourceListener from this DragSource. If a null listener is specified, no action is taken and no exception is thrown. If the listener specified by the argument was not previously added to this DragSource, no action is taken and no exception is thrown.

 public  void removeDragSourceMotionListener(DragSourceMotionListener dsml) 
{
        if (dsml != null) {
            synchronized (this) {
                motionListener = DnDEventMulticaster.remove(motionListener, dsml);
            }
        }
}

Removes the specified DragSourceMotionListener from this DragSource. If a null listener is specified, no action is taken and no exception is thrown. If the listener specified by the argument was not previously added to this DragSource, no action is taken and no exception is thrown.

 public  void startDrag(DragGestureEvent trigger,
    Cursor dragCursor,
    Transferable transferable,
    DragSourceListener dsl) throws InvalidDnDOperationException 
{
        startDrag(trigger, dragCursor, null, null, transferable, dsl, null);
}

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Transferable subject data of the drag, and the DragSourceListener.

 public  void startDrag(DragGestureEvent trigger,
    Cursor dragCursor,
    Transferable transferable,
    DragSourceListener dsl,
    FlavorMap flavorMap) throws InvalidDnDOperationException 
{
        startDrag(trigger, dragCursor, null, null, transferable, dsl, flavorMap);
}

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Transferable subject data of the drag, the DragSourceListener, and the FlavorMap.

 public  void startDrag(DragGestureEvent trigger,
    Cursor dragCursor,
    Image dragImage,
    Point dragOffset,
    Transferable transferable,
    DragSourceListener dsl) throws InvalidDnDOperationException 
{
        startDrag(trigger, dragCursor, dragImage, dragOffset, transferable, dsl, null);
}

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Image to drag, the offset of the Image origin from the hotspot of the Cursor at the instant of the trigger, the subject data of the drag, and the DragSourceListener.

 public  void startDrag(DragGestureEvent trigger,
    Cursor dragCursor,
    Image dragImage,
    Point imageOffset,
    Transferable transferable,
    DragSourceListener dsl,
    FlavorMap flavorMap) throws InvalidDnDOperationException 
{
        SunDragSourceContextPeer.setDragDropInProgress(true);
        try {
            if (flavorMap != null) this.flavorMap = flavorMap;
            DragSourceContextPeer dscp = Toolkit.getDefaultToolkit().createDragSourceContextPeer(trigger);
            DragSourceContext     dsc = createDragSourceContext(dscp,
                                                                trigger,
                                                                dragCursor,
                                                                dragImage,
                                                                imageOffset,
                                                                transferable,
                                                                dsl
                                                                );
            if (dsc == null) {
                throw new InvalidDnDOperationException();
            }
            dscp.startDrag(dsc, dsc.getCursor(), dragImage, imageOffset); // may throw
        } catch (RuntimeException e) {
            SunDragSourceContextPeer.setDragDropInProgress(false);
            throw e;
        }
}

Start a drag, given the DragGestureEvent that initiated the drag, the initial Cursor to use, the Image to drag, the offset of the Image origin from the hotspot of the Cursor at the instant of the trigger, the Transferable subject data of the drag, the DragSourceListener, and the FlavorMap.