JDK-4070498 : Scrollbar documentation is wrong on what the parameters are.
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 1.1.3,1.1.4,1.1.5
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • OS: solaris_2.5.1,windows_95,windows_nt
  • CPU: x86,sparc
  • Submitted: 1997-08-08
  • Updated: 1999-01-15
  • Resolved: 1999-01-15
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 Availability Release.

To download the current JDK release, click here.
Other
1.2.0 1.2fcsFixed
Related Reports
Duplicate :  
JDK-4094136 - Scrollbar behaviour doesn't match description at Maximum parameter
Duplicate :  
JDK-4098739 - JDK 1.1.5 Scrollbar maximum value behavior differs from API
Description

Name: rlT66838			Date: 08/07/97


The documentation for scroll bars refers to how
scrollbars previously worked (but will no longer
work) which may explain why when I run an
application written for 1.02 the scrollbars don't
behave correctly.  The way the maximum is described
is incorrect and following the description gives 
screwy results. The maximum is described as being
the left edge of the visible ( for horizontal)
which means you could have a maximum of zero (if
your visible area was your entire area). That is
not possible with the current implementation. You
cannot set maximum to zero and you can't set visible
to greater than maximum. So if you look at your
example you will see that what maximum should be
set to is 255 + 64 not 255. This behaviour is
consistent for Solaris 2.5 and Windows NT 4.0.

======================================================================
Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: generic FIXED IN: 1.2fcs INTEGRATED IN: 1.2fcs
14-06-2004
WORK AROUND Name: rlT66838 Date: 08/07/97 The workaround is setting maximum to what I previously used for the maximum plus visible. ======================================================================
11-06-2004
EVALUATION Yes, the behavior of Scrollbar changed with JDK 1.1, but the specs did not change. Jeff Dunn verified that the change in behavior was intentional. Jeff writes: "It turns out that there is a good reason to change the spec. In the 1.0 model, if the visible size of the bubble changed, the range of the entire scrollbar would also change, which is not good. With the new model, the range of the scrollbar does not change unless the programmer does it explicitly." So, I updated the spec to accurately describe how the maximum parameter works. dale.green@eng 1998-08-24
24-08-1998