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

ListSelectionEvent JavaDoc

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Open
    • Priority: P4
    • Resolution: Unresolved
    • Affects Version/s: 6
    • Fix Version/s: None
    • Component/s: client-libs

      Description

      The constructor for ListSelectionEvent documents the fact
      that firstIndex <= lastIndex. The getFirstIndex(), getLastIndex()
      methods' javadoc doesn't mention this. Since most developers
      aren't creating ListSelectionEvents, they're just dealing with
      them, it would be helpful to advertise the firstIndex <= lastIndex
      inequality in the methods' javadoc.

      Also: this is the javadoc for valueIsAdjusting:

         Returns true if this is one of multiple change events.

         Returns:
             true if this is one of a rapid series of events

      It doesn't seem seem sensible for the @returns text to be slightly
      different than the main javadoc ("rapid")? It would be useful to
      point out that typcially (at least), isAdjusting is true in the
      middle of a selection change that's tracking a series of mouse-dragged
      events.

        Attachments

          Activity

            People

            Assignee:
            Unassigned Unassigned
            Reporter:
            shickeysunw Shannon Hickey (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Dates

              Created:
              Updated:
              Imported:
              Indexed: