JDK-4682598 : Adjustable.setValue() docs should suggest respecting the visible amount
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 1.4.1
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2002-05-09
  • Updated: 2017-05-16
  • Resolved: 2003-10-23
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availabitlity Release.

To download the current JDK release, click here.
Other
5.0 b26Fixed
Related Reports
Relates :  
Description
This bug was inspired by bug 4681561 : Adjustable.setValue() does not set value.

Adjustables have properties for the current value, minimum and maximum values, as well as a visibleAmount, which represents how much of a document is visible.  

Adjustable.setValue() specifies only that the new value be between the minimum and maximum values.

The setValue() method in Scrollbar, which implements Adjustable, further specifies that the new value should not be greater than maximum - visibleAmount.

The revered tomb, "The Java Class Libraries Second Edition, Volume 2", in its section on the Adjustable interface, discusses the visible amount, and suggests following the rules implemented by Scrollbar.  Pulling some of this material into the JavaDoc could be helpful to many.

Keeping the suggestive tone would be appropriate, as something stronger might get into API-change territory.

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger tiger-beta FIXED IN: tiger tiger-beta INTEGRATED IN: tiger-b26 tiger-beta
2004-06-14

PUBLIC COMMENTS .
2004-06-10

EVALUATION Will fix for tiger. ###@###.### 2002-08-02 Reviewed by Brent. CCC approved. Fixed for tiger. ###@###.### 2003-09-12
2002-08-02