Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4219339

incomplete doc for java.awt.dnd.DragGestureRecognizer

XMLWordPrintable

    • sparc
    • solaris_2.5.1

      Name: sdC67446 Date: 03/11/99


      The docs for java.awt.dnd.DragGestureRecognizer.setSourceActions says:

      public void setSourceActions(int actions)

             This method sets the permitted source drag action(s) for this
             Drag and Drop operation.
             Parameters:
                    actions - the permitted source drag action(s)

       It is not clear what does it mean "permitted source drag action(s)"?
       Precise values are needed.

      The doc for ctors says:
      --------------
      protected DragGestureRecognizer(DragSource ds,
                                      Component c,
                                      int sa,
                                      DragGestureListener dgl)

             Construct a new DragGestureRecognizer given the DragSource to
             be used in this Drag and Drop operation, the Component this
             DragGestureRecognizer should "observe" for drag initiating
             gestures, the action(s) supported for this Drag and Drop
             operation, and the DragGestureListener to notify once a drag
             initiating gesture has been detected.

             Parameters:
                    ds - the DragSource this DragGestureRecognizer will use
                    to process the Drag and Drop operation
                    c - the Component this DragGestureRecognizer should
                    "observe" the event stream to, in order to detect a drag
                    initiating gesture. If this value is null, the
                    DragGestureRecognizer is not associated with any
                    Component.
                    sa - the set (logical OR) of the DnDConstants that this
                    Drag and Drop operation will support
                    dgl - the DragGestureRecognizer to notify when a drag
                    gesture is detected

             Throws:
                    IllegalArgumentException - if ds is null.

      It is unspecified the behavior if 'dgl' == null.
      Also the phrase "sa - the set (logical OR) of the DnDConstants that this Drag
      and Drop operation will support" is partly wrong. It is not "logical OR" but
      binary.
      --------------
      ======================================================================

            denis Denis Fokin (Inactive)
            dsvsunw Dsv Dsv (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Imported:
              Indexed: