Name: sdC67446 Date: 03/11/99


The doc for class java.awt.dnd.DragSource
doesn't specify the behavior of methods:

public void
addDragGestureListener(DragGestureListener dgl)

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Image dragImage,
                      Point imageOffset,
                      Transferable transferable,
                      DragSourceListener dsl,
                      FlavorMap flavorMap)

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl,
                      FlavorMap flavorMap)

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Image dragImage,
                      Point dragOffset,
                      Transferable transferable,
                      DragSourceListener dsl)

public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl)

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

public DragGestureRecognizer
createDragGestureRecognizer(Class recognizerAbstractClass,
                            Component c,
                            int actions,
                            DragGestureListener dgl)

public DragGestureRecognizer
createDefaultDragGestureRecognizer(Component c,
                                   int actions,
                                   DragGestureListener dgl)

for some null parameters. Also unspecified the valid range for
input int parameters.
The doc says:
________
public void startDrag(DragGestureEvent trigger,
                      Cursor dragCursor,
                      Image dragImage,
                      Point imageOffset,
                      Transferable transferable,
                      DragSourceListener dsl,
                      FlavorMap flavorMap)
               throws InvalidDnDOperationException

       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.

       Parameters:
              trigger - The DragGestureEvent that initiated the drag
              dragCursor - The initial Cursor or null for defaults
              dragImage - The image to drag or null,
              imageOffset - The offset of the Image origin from the
              hotspot of the Cursor at the instant of the trigger
              transferable - The subject data of the drag
              dsl - The DragSourceListener
              flavorMap - The FlavorMap to use, or null

       Throws:
              java.awt.dnd.InvalidDnDOperationException - if the Drag
              and Drop system is unable to initiate a drag operation,
              or if the user attempts to start a drag while an
              existing drag operation is still executing.
________
protected DragSourceContext
createDragSourceContext(DragSourceContextPeer dscp,
                        DragGestureEvent dgl,
                        Cursor dragCursor,
                        Image dragImage,
                        Point imageOffset,
                        Transferable t,
                        DragSourceListener dsl)

       Create the DragSourceContext to handle this drag. To
       incorporate a new DragSourceContext subclass, subclass
       DragSource and override this method.

       Parameters:
              dscp - The DragSourceContextPeer for this drag
              trigger - The DragGestureEvent that triggered the drag
              dragCursor - The initial Cursor to display
              dragImage - The Image to drag or null
              imageOffset - The offset of the Image origin from the
              hotspot of the cursor at the instant of the trigger
              transferable - The subject data of the drag
              dsl - The DragSourceListener

       Returns:
              the DragSourceContext
________
======================================================================