Java Doc for Scrollbar.java in  » 6.0-JDK-Modules » j2me » java » awt » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » 6.0 JDK Modules » j2me » java.awt 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   java.awt.Component
      java.awt.Scrollbar

Scrollbar
public class Scrollbar extends Component implements Adjustable(Code)
The Scrollbar class embodies a scroll bar, a familiar user-interface object. A scroll bar provides a convenient means for allowing a user to select from a range of values. The following three vertical scroll bars could be used as slider controls to pick the red, green, and blue components of a color:

Each scroll bar in this example could be created with code similar to the following:


 redSlider=new Scrollbar(Scrollbar.VERTICAL, 0, 1, 0, 255);
 add(redSlider);
 

Alternatively, a scroll bar can represent a range of values. For example, if a scroll bar is used for scrolling through text, the width of the "bubble" or "thumb" can represent the amount of text that is visible. Here is an example of a scroll bar that represents a range:

The value range represented by the bubble is the visible range of the scroll bar. The horizontal scroll bar in this example could be created with code like the following:


 ranger = new Scrollbar(Scrollbar.HORIZONTAL, 0, 60, 0, 300);
 add(ranger);
 

Note that the actual maximum value of the scroll bar is the maximum minus the visible. In the previous example, because the maximum is 300 and the visible is 60, the actual maximum value is 240. The range of the scrollbar track is 0 - 300. The left side of the bubble indicates the value of the scroll bar.

Normally, the user changes the value of the scroll bar by making a gesture with the mouse. For example, the user can drag the scroll bar's bubble up and down, or click in the scroll bar's unit increment or block increment areas. Keyboard gestures can also be mapped to the scroll bar. By convention, the Page Up and Page Down keys are equivalent to clicking in the scroll bar's block increment and block decrement areas.

When the user changes the value of the scroll bar, the scroll bar receives an instance of AdjustmentEvent. The scroll bar processes this event, passing it along to any registered listeners.

Any object that wishes to be notified of changes to the scroll bar's value should implement AdjustmentListener, an interface defined in the package java.awt.event. Listeners can be added and removed dynamically by calling the methods addAdjustmentListener and removeAdjustmentListener.

The AdjustmentEvent class defines five types of adjustment event, listed here:

  • AdjustmentEvent.TRACK is sent out when the user drags the scroll bar's bubble.
  • AdjustmentEvent.UNIT_INCREMENT is sent out when the user clicks in the left arrow of a horizontal scroll bar, or the top arrow of a vertical scroll bar, or makes the equivalent gesture from the keyboard.
  • AdjustmentEvent.UNIT_DECREMENT is sent out when the user clicks in the right arrow of a horizontal scroll bar, or the bottom arrow of a vertical scroll bar, or makes the equivalent gesture from the keyboard.
  • AdjustmentEvent.BLOCK_INCREMENT is sent out when the user clicks in the track, to the left of the bubble on a horizontal scroll bar, or above the bubble on a vertical scroll bar. By convention, the Page Up key is equivalent, if the user is using a keyboard that defines a Page Up key.
  • AdjustmentEvent.BLOCK_DECREMENT is sent out when the user clicks in the track, to the right of the bubble on a horizontal scroll bar, or below the bubble on a vertical scroll bar. By convention, the Page Down key is equivalent, if the user is using a keyboard that defines a Page Down key.

The JDK 1.0 event system is supported for backwards compatibility, but its use with newer versions of the platform is discouraged. The fives types of adjustment event introduced with JDK 1.1 correspond to the five event types that are associated with scroll bars in previous platform versions. The following list gives the adjustment event type, and the corresponding JDK 1.0 event type it replaces.

  • AdjustmentEvent.TRACK replaces Event.SCROLL_ABSOLUTE
  • AdjustmentEvent.UNIT_INCREMENT replaces Event.SCROLL_LINE_UP
  • AdjustmentEvent.UNIT_DECREMENT replaces Event.SCROLL_LINE_DOWN
  • AdjustmentEvent.BLOCK_INCREMENT replaces Event.SCROLL_PAGE_UP
  • AdjustmentEvent.BLOCK_DECREMENT replaces Event.SCROLL_PAGE_DOWN


version:
   1.76 08/19/02
author:
   Sami Shaio
See Also:   java.awt.event.AdjustmentEvent
See Also:   java.awt.event.AdjustmentListener
since:
   JDK1.0



Field Summary
final public static  intHORIZONTAL
     A constant that indicates a horizontal scroll bar.
final public static  intVERTICAL
     A constant that indicates a vertical scroll bar.
transient  AdjustmentListeneradjustmentListener
    
 intlineIncrement
     The amount by which the scrollbar value will change when going up or down by a line.
 intmaximum
     The maximum value of the Scrollbar.
 intminimum
     The minimum value of the Scrollbar.
 intorientation
     The Scrollbar's orientation--being either horizontal or vertical.
 intpageIncrement
     The amount by which the scrollbar value will change when going up or down by a page.
 intvalue
     The value of the Scrollbar.
 intvisibleAmount
     The size of the visible portion of the Scrollbar.

Constructor Summary
public  Scrollbar()
     Constructs a new vertical scroll bar.
public  Scrollbar(int orientation)
     Constructs a new scroll bar with the specified orientation.
public  Scrollbar(int orientation, int value, int visible, int minimum, int maximum)
     Constructs a new scroll bar with the specified orientation, initial value, page size, and minimum and maximum values.

The orientation argument must take one of the two values Scrollbar.HORIZONTAL, or Scrollbar.VERTICAL, indicating a horizontal or vertical scroll bar, respectively.

The parameters supplied to this constructor are subject to the constraints described in Scrollbar.setValues(int,int,int,int) .


Method Summary
public synchronized  voidaddAdjustmentListener(AdjustmentListener l)
     Adds the specified adjustment listener to receive instances of AdjustmentEvent from this scroll bar.
public  voidaddNotify()
     Creates the Scrollbar's peer.
 StringconstructComponentName()
     Construct a name for this component.
 booleaneventEnabled(AWTEvent e)
    
public synchronized  AdjustmentListener[]getAdjustmentListeners()
     Returns an array of all the adjustment listeners registered on this scrollbar.
public  intgetBlockIncrement()
     Gets the block increment of this scroll bar.

The block increment is the value that is added or subtracted when the user activates the block increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The block increment must be greater than zero.

public  intgetLineIncrement()
    
public  intgetMaximum()
     Gets the maximum value of this scroll bar.
public  intgetMinimum()
     Gets the minimum value of this scroll bar.
public  intgetOrientation()
     Determines the orientation of this scroll bar.
public  intgetPageIncrement()
    
public  intgetUnitIncrement()
     Gets the unit increment for this scrollbar.

The unit increment is the value that is added or subtracted when the user activates the unit increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The unit increment must be greater than zero.

public  intgetValue()
     Gets the current value of this scroll bar.
public  intgetVisible()
    
public  intgetVisibleAmount()
     Gets the visible amount of this scroll bar.

When a scroll bar is used to select a range of values, the visible amount is used to represent the range of values that are currently visible.

protected  StringparamString()
     Returns the parameter string representing the state of this scroll bar.
protected  voidprocessAdjustmentEvent(AdjustmentEvent e)
     Processes adjustment events occurring on this scrollbar by dispatching them to any registered AdjustmentListener objects.

This method is not called unless adjustment events are enabled for this component.

protected  voidprocessEvent(AWTEvent e)
     Processes events on this scroll bar.
public synchronized  voidremoveAdjustmentListener(AdjustmentListener l)
     Removes the specified adjustment listener so that it no longer receives instances of AdjustmentEvent from this scroll bar.
public  voidsetBlockIncrement(int v)
     Sets the block increment for this scroll bar.

The block increment is the value that is added or subtracted when the user activates the block increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The block increment must be greater than zero.

public synchronized  voidsetLineIncrement(int v)
    
public  voidsetMaximum(int newMaximum)
     Sets the maximum value of this scroll bar.
public  voidsetMinimum(int newMinimum)
     Sets the minimum value of this scroll bar.

When setMinimum is called, the minimum value is changed, and other values (including the maximum, the visible amount, and the current scroll bar value) are changed to be consistent with the new minimum.

public  voidsetOrientation(int orientation)
     Sets the orientation for this scroll bar.
public synchronized  voidsetPageIncrement(int v)
    
public  voidsetUnitIncrement(int v)
     Sets the unit increment for this scroll bar.

The unit increment is the value that is added or subtracted when the user activates the unit increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The unit increment must be greater than zero.

public  voidsetValue(int newValue)
     Sets the value of this scroll bar to the specified value.
public  voidsetValues(int value, int visible, int minimum, int maximum)
     Sets the values of four properties for this scroll bar: value, visibleAmount, minimum, and maximum. If the values supplied for these properties are inconsistent or incorrect, they will be changed to ensure consistency.
public  voidsetVisibleAmount(int newAmount)
     Sets the visible amount of this scroll bar.

When a scroll bar is used to select a range of values, the visible amount is used to represent the range of values that are currently visible.


Field Detail
HORIZONTAL
final public static int HORIZONTAL(Code)
A constant that indicates a horizontal scroll bar.



VERTICAL
final public static int VERTICAL(Code)
A constant that indicates a vertical scroll bar.



adjustmentListener
transient AdjustmentListener adjustmentListener(Code)



lineIncrement
int lineIncrement(Code)
The amount by which the scrollbar value will change when going up or down by a line. This value should be a non negative integer.
See Also:    setLineIncrement()
See Also:    getLineIncrement()



maximum
int maximum(Code)
The maximum value of the Scrollbar. This value must be greater than the minimum value.
This integer can be either positive or negative, and it's range can be altered at any time.
See Also:    getMaximum()
See Also:    setMaximum()



minimum
int minimum(Code)
The minimum value of the Scrollbar. This value must be greater than the minimum value.
This integer can be either positive or negative.
See Also:    getMinimum()
See Also:    setMinimum()



orientation
int orientation(Code)
The Scrollbar's orientation--being either horizontal or vertical. This value should be specified when the scrollbar is being created.
orientation can be either : VERTICAL or HORIZONTAL only.
See Also:    getOrientation()
See Also:    setOrientation()



pageIncrement
int pageIncrement(Code)
The amount by which the scrollbar value will change when going up or down by a page. This value should be a non negative integer.
See Also:    setPageIncrement()
See Also:    getPageIncrement()



value
int value(Code)
The value of the Scrollbar. value should be either greater than minimum or less that maximum
See Also:    getValue()
See Also:    setValue()



visibleAmount
int visibleAmount(Code)
The size of the visible portion of the Scrollbar. The size of the scrollbox is normally used to indicate the visibleAmount.
See Also:    getVisibleAmount()
See Also:    setVisibleAmount()




Constructor Detail
Scrollbar
public Scrollbar()(Code)
Constructs a new vertical scroll bar. The default properties of the scroll bar are listed in the following table:

Property Description Default Value
orientation indicates if the scroll bar is vertical or horizontal Scrollbar.VERTICAL
value value which controls the location
of the scroll bar bubble
0
minimum minimum value of the scroll bar 0
maximum maximum value of the scroll bar 100
unit increment amount the value changes when the
Line Up or Line Down key is pressed,
or when the end arrows of the scrollbar
are clicked
1
block increment amount the value changes when the
Page Up or Page Down key is pressed,
or when the scrollbar track is clicked
on either side of the bubble
10



Scrollbar
public Scrollbar(int orientation)(Code)
Constructs a new scroll bar with the specified orientation.

The orientation argument must take one of the two values Scrollbar.HORIZONTAL, or Scrollbar.VERTICAL, indicating a horizontal or vertical scroll bar, respectively.
Parameters:
  orientation - indicates the orientation of the scroll bar.
exception:
  IllegalArgumentException - when an illegal value forthe orientation argument is supplied.




Scrollbar
public Scrollbar(int orientation, int value, int visible, int minimum, int maximum)(Code)
Constructs a new scroll bar with the specified orientation, initial value, page size, and minimum and maximum values.

The orientation argument must take one of the two values Scrollbar.HORIZONTAL, or Scrollbar.VERTICAL, indicating a horizontal or vertical scroll bar, respectively.

The parameters supplied to this constructor are subject to the constraints described in Scrollbar.setValues(int,int,int,int) .
Parameters:
  orientation - indicates the orientation of the scroll bar.
Parameters:
  value - the initial value of the scroll bar
Parameters:
  visible - the visible amount of the scroll bar, typically represented by the size of the bubble
Parameters:
  minimum - the minimum value of the scroll bar
Parameters:
  maximum - the maximum value of the scroll bar
exception:
  IllegalArgumentException - when an illegal value forthe orientation argument is supplied
See Also:   Scrollbar.setValues





Method Detail
addAdjustmentListener
public synchronized void addAdjustmentListener(AdjustmentListener l)(Code)
Adds the specified adjustment listener to receive instances of AdjustmentEvent from this scroll bar. If l is null, no exception is thrown and no action is performed.
Parameters:
  l - the adjustment listener.
See Also:   java.awt.event.AdjustmentEvent
See Also:   java.awt.event.AdjustmentListener
See Also:   java.awt.Scrollbar.removeAdjustmentListener
since:
   JDK1.1



addNotify
public void addNotify()(Code)
Creates the Scrollbar's peer. The peer allows you to modify the appearance of the Scrollbar without changing any of its functionality.



constructComponentName
String constructComponentName()(Code)
Construct a name for this component. Called by getName() when the name is null.



eventEnabled
boolean eventEnabled(AWTEvent e)(Code)



getAdjustmentListeners
public synchronized AdjustmentListener[] getAdjustmentListeners()(Code)
Returns an array of all the adjustment listeners registered on this scrollbar. all of this scrollbar's AdjustmentListenersor an empty array if no adjustmentlisteners are currently registered
See Also:   Scrollbar.addAdjustmentListener
See Also:   Scrollbar.removeAdjustmentListener
See Also:   java.awt.event.AdjustmentEvent
See Also:   java.awt.event.AdjustmentListener
since:
   1.4



getBlockIncrement
public int getBlockIncrement()(Code)
Gets the block increment of this scroll bar.

The block increment is the value that is added or subtracted when the user activates the block increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The block increment must be greater than zero. the block increment of this scroll bar
See Also:   java.awt.Scrollbar.setBlockIncrement
since:
   JDK1.1




getLineIncrement
public int getLineIncrement()(Code)



getMaximum
public int getMaximum()(Code)
Gets the maximum value of this scroll bar. the maximum value of this scroll bar.
See Also:   java.awt.Scrollbar.getValue
See Also:   java.awt.Scrollbar.getMinimum



getMinimum
public int getMinimum()(Code)
Gets the minimum value of this scroll bar. the minimum value of this scroll bar.
See Also:   java.awt.Scrollbar.getValue
See Also:   java.awt.Scrollbar.getMaximum



getOrientation
public int getOrientation()(Code)
Determines the orientation of this scroll bar. the orientation of this scroll bar, eitherScrollbar.HORIZONTAL orScrollbar.VERTICAL.
See Also:   java.awt.Scrollbar.setOrientation



getPageIncrement
public int getPageIncrement()(Code)



getUnitIncrement
public int getUnitIncrement()(Code)
Gets the unit increment for this scrollbar.

The unit increment is the value that is added or subtracted when the user activates the unit increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The unit increment must be greater than zero. the unit increment of this scroll bar
See Also:   java.awt.Scrollbar.setUnitIncrement
since:
   JDK1.1




getValue
public int getValue()(Code)
Gets the current value of this scroll bar. the current value of this scroll bar.
See Also:   java.awt.Scrollbar.getMinimum
See Also:   java.awt.Scrollbar.getMaximum



getVisible
public int getVisible()(Code)



getVisibleAmount
public int getVisibleAmount()(Code)
Gets the visible amount of this scroll bar.

When a scroll bar is used to select a range of values, the visible amount is used to represent the range of values that are currently visible. The size of the scroll bar's bubble (also called a thumb or scroll box), usually gives a visual representation of the relationship of the visible amount to the range of the scroll bar.

The scroll bar's bubble may not be displayed when it is not moveable (e.g. when it takes up the entire length of the scroll bar's track, or when the scroll bar is disabled). Whether the bubble is displayed or not will not affect the value returned by getVisibleAmount. the visible amount of this scroll bar
See Also:   java.awt.Scrollbar.setVisibleAmount
since:
   JDK1.1




paramString
protected String paramString()(Code)
Returns the parameter string representing the state of this scroll bar. This string is useful for debugging. the parameter string of this scroll bar.



processAdjustmentEvent
protected void processAdjustmentEvent(AdjustmentEvent e)(Code)
Processes adjustment events occurring on this scrollbar by dispatching them to any registered AdjustmentListener objects.

This method is not called unless adjustment events are enabled for this component. Adjustment events are enabled when one of the following occurs:

  • An AdjustmentListener object is registered via addAdjustmentListener.
  • Adjustment events are enabled via enableEvents.


Parameters:
  e - the adjustment event.
See Also:   java.awt.event.AdjustmentEvent
See Also:   java.awt.event.AdjustmentListener
See Also:   java.awt.Scrollbar.addAdjustmentListener
See Also:   java.awt.Component.enableEvents
since:
   JDK1.1




processEvent
protected void processEvent(AWTEvent e)(Code)
Processes events on this scroll bar. If the event is an instance of AdjustmentEvent, it invokes the processAdjustmentEvent method. Otherwise, it invokes its superclass's processEvent method.
Parameters:
  e - the event.
See Also:   java.awt.event.AdjustmentEvent
See Also:   java.awt.Scrollbar.processAdjustmentEvent
since:
   JDK1.1



removeAdjustmentListener
public synchronized void removeAdjustmentListener(AdjustmentListener l)(Code)
Removes the specified adjustment listener so that it no longer receives instances of AdjustmentEvent from this scroll bar. If l is null, no exception is thrown and no action is performed.
Parameters:
  l - the adjustment listener.
See Also:   java.awt.event.AdjustmentEvent
See Also:   java.awt.event.AdjustmentListener
See Also:   java.awt.Scrollbar.addAdjustmentListener
since:
   JDK1.1



setBlockIncrement
public void setBlockIncrement(int v)(Code)
Sets the block increment for this scroll bar.

The block increment is the value that is added or subtracted when the user activates the block increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The block increment must be greater than zero. Attepts to set the block increment to a value lower than 1 will result in a value of 1 being set.
Parameters:
  v - the amount by which to increment or decrementthe scroll bar's value
See Also:   java.awt.Scrollbar.getBlockIncrement
since:
   JDK1.1




setLineIncrement
public synchronized void setLineIncrement(int v)(Code)



setMaximum
public void setMaximum(int newMaximum)(Code)
Sets the maximum value of this scroll bar.

When setMaximum is called, the maximum value is changed, and other values (including the minimum, the visible amount, and the current scroll bar value) are changed to be consistent with the new maximum.

Normally, a program should change a scroll bar's maximum value only by calling setValues. The setValues method simultaneously and synchronously sets the minimum, maximum, visible amount, and value properties of a scroll bar, so that they are mutually consistent.

Note that setting the maximum value to Integer.MIN_VALUE will result in the new maximum value being set to Integer.MIN_VALUE + 1.
Parameters:
  newMaximum - the new maximum valuefor this scroll bar
See Also:   java.awt.Scrollbar.setValues
See Also:   java.awt.Scrollbar.setMinimum
since:
   JDK1.1




setMinimum
public void setMinimum(int newMinimum)(Code)
Sets the minimum value of this scroll bar.

When setMinimum is called, the minimum value is changed, and other values (including the maximum, the visible amount, and the current scroll bar value) are changed to be consistent with the new minimum.

Normally, a program should change a scroll bar's minimum value only by calling setValues. The setValues method simultaneously and synchronously sets the minimum, maximum, visible amount, and value properties of a scroll bar, so that they are mutually consistent.

Note that setting the minimum value to Integer.MAX_VALUE will result in the new minimum value being set to Integer.MAX_VALUE - 1.
Parameters:
  newMinimum - the new minimum value for this scroll bar
See Also:   java.awt.Scrollbar.setValues
See Also:   java.awt.Scrollbar.setMaximum
since:
   JDK1.1




setOrientation
public void setOrientation(int orientation)(Code)
Sets the orientation for this scroll bar.
Parameters:
  the - orientation of this scroll bar, eitherScrollbar.HORIZONTAL orScrollbar.VERTICAL.
See Also:   java.awt.Scrollbar.getOrientation
exception:
  IllegalArgumentException - if the value suppliedfor orientation is not alegal value.
since:
   JDK1.1



setPageIncrement
public synchronized void setPageIncrement(int v)(Code)



setUnitIncrement
public void setUnitIncrement(int v)(Code)
Sets the unit increment for this scroll bar.

The unit increment is the value that is added or subtracted when the user activates the unit increment area of the scroll bar, generally through a mouse or keyboard gesture that the scroll bar receives as an adjustment event. The unit increment must be greater than zero. Attepts to set the unit increment to a value lower than 1 will result in a value of 1 being set.
Parameters:
  v - the amount by which to increment or decrementthe scroll bar's value
See Also:   java.awt.Scrollbar.getUnitIncrement
since:
   JDK1.1




setValue
public void setValue(int newValue)(Code)
Sets the value of this scroll bar to the specified value.

If the value supplied is less than the current minimum or greater than the current maximum - visibleAmount, then either minimum or maximum - visibleAmount is substituted, as appropriate.

Normally, a program should change a scroll bar's value only by calling setValues. The setValues method simultaneously and synchronously sets the minimum, maximum, visible amount, and value properties of a scroll bar, so that they are mutually consistent.
Parameters:
  newValue - the new value of the scroll bar
See Also:   java.awt.Scrollbar.setValues
See Also:   java.awt.Scrollbar.getValue
See Also:   java.awt.Scrollbar.getMinimum
See Also:   java.awt.Scrollbar.getMaximum




setValues
public void setValues(int value, int visible, int minimum, int maximum)(Code)
Sets the values of four properties for this scroll bar: value, visibleAmount, minimum, and maximum. If the values supplied for these properties are inconsistent or incorrect, they will be changed to ensure consistency.

This method simultaneously and synchronously sets the values of four scroll bar properties, assuring that the values of these properties are mutually consistent. It enforces the following constraints: maximum must be greater than minimum, maximum - minimum must not be greater than Integer.MAX_VALUE, visibleAmount must be greater than zero. visibleAmount must not be greater than maximum - minimum, value must not be less than minimum, and value must not be greater than maximum - visibleAmount
Parameters:
  value - is the position in the current window
Parameters:
  visible - is the visible amount of the scroll bar
Parameters:
  minimum - is the minimum value of the scroll bar
Parameters:
  maximum - is the maximum value of the scroll bar
See Also:   Scrollbar.setMinimum
See Also:   Scrollbar.setMaximum
See Also:   Scrollbar.setVisibleAmount
See Also:   Scrollbar.setValue




setVisibleAmount
public void setVisibleAmount(int newAmount)(Code)
Sets the visible amount of this scroll bar.

When a scroll bar is used to select a range of values, the visible amount is used to represent the range of values that are currently visible. The size of the scroll bar's bubble (also called a thumb or scroll box), usually gives a visual representation of the relationship of the visible amount to the range of the scroll bar.

The scroll bar's bubble may not be displayed when it is not moveable (e.g. when it takes up the entire length of the scroll bar's track, or when the scroll bar is disabled). Whether the bubble is displayed or not will not affect the value returned by getVisibleAmount.

If the visible amount supplied is less than one or greater than the current maximum - minimum, then either one or maximum - minimum is substituted, as appropriate.

Normally, a program should change a scroll bar's value only by calling setValues. The setValues method simultaneously and synchronously sets the minimum, maximum, visible amount, and value properties of a scroll bar, so that they are mutually consistent.
Parameters:
  newAmount - the new visible amount
See Also:   java.awt.Scrollbar.getVisibleAmount
See Also:   java.awt.Scrollbar.setValues
since:
   JDK1.1




Fields inherited from java.awt.Component
final public static float BOTTOM_ALIGNMENT(Code)(Java Doc)
final public static float CENTER_ALIGNMENT(Code)(Java Doc)
final public static float LEFT_ALIGNMENT(Code)(Java Doc)
final static Object LOCK(Code)(Java Doc)
final public static float RIGHT_ALIGNMENT(Code)(Java Doc)
final public static float TOP_ALIGNMENT(Code)(Java Doc)
final static String actionListenerK(Code)(Java Doc)
final static String adjustmentListenerK(Code)(Java Doc)
Color background(Code)(Java Doc)
transient ComponentListener componentListener(Code)(Java Doc)
final static String componentListenerK(Code)(Java Doc)
final static String containerListenerK(Code)(Java Doc)
Cursor cursor(Code)(Java Doc)
final static boolean defaultNewEventsOnly(Code)(Java Doc)
transient Component delegate(Code)(Java Doc)
transient Component delegateSource(Code)(Java Doc)
boolean enabled(Code)(Java Doc)
long eventMask(Code)(Java Doc)
transient FocusListener focusListener(Code)(Java Doc)
final static String focusListenerK(Code)(Java Doc)
Font font(Code)(Java Doc)
Color foreground(Code)(Java Doc)
int height(Code)(Java Doc)
static int incRate(Code)(Java Doc)
static boolean isInc(Code)(Java Doc)
final static String itemListenerK(Code)(Java Doc)
transient KeyListener keyListener(Code)(Java Doc)
final static String keyListenerK(Code)(Java Doc)
Locale locale(Code)(Java Doc)
Dimension minSize(Code)(Java Doc)
transient MouseListener mouseListener(Code)(Java Doc)
final static String mouseListenerK(Code)(Java Doc)
transient MouseMotionListener mouseMotionListener(Code)(Java Doc)
final static String mouseMotionListenerK(Code)(Java Doc)
boolean newEventsOnly(Code)(Java Doc)
transient Container parent(Code)(Java Doc)
Vector popups(Code)(Java Doc)
Dimension prefSize(Code)(Java Doc)
final static String textListenerK(Code)(Java Doc)
static Timer updateTimer(Code)(Java Doc)
boolean valid(Code)(Java Doc)
boolean visible(Code)(Java Doc)
int width(Code)(Java Doc)
transient RuntimeException windowClosingException(Code)(Java Doc)
final static String windowListenerK(Code)(Java Doc)
int x(Code)(Java Doc)
transient ComponentXWindow xwindow(Code)(Java Doc)
int y(Code)(Java Doc)

Methods inherited from java.awt.Component
public boolean action(Event evt, Object what)(Code)(Java Doc)
public synchronized void add(PopupMenu popup)(Code)(Java Doc)
public synchronized void addComponentListener(ComponentListener l)(Code)(Java Doc)
public synchronized void addFocusListener(FocusListener l)(Code)(Java Doc)
public synchronized void addKeyListener(KeyListener l)(Code)(Java Doc)
public synchronized void addMouseListener(MouseListener l)(Code)(Java Doc)
public synchronized void addMouseMotionListener(MouseMotionListener l)(Code)(Java Doc)
public void addNotify()(Code)(Java Doc)
boolean areInputMethodsEnabled()(Code)(Java Doc)
public Rectangle bounds()(Code)(Java Doc)
final void checkEnableNewEventsOnly(Object listener)(Code)(Java Doc)
public int checkImage(Image image, ImageObserver observer)(Code)(Java Doc)
public int checkImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc)
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)(Code)(Java Doc)
String constructComponentName()(Code)(Java Doc)
public boolean contains(int x, int y)(Code)(Java Doc)
public boolean contains(Point p)(Code)(Java Doc)
public Image createImage(ImageProducer producer)(Code)(Java Doc)
public Image createImage(int width, int height)(Code)(Java Doc)
ComponentXWindow createXWindow()(Code)(Java Doc)
public void deliverEvent(Event e)(Code)(Java Doc)
public void disable()(Code)(Java Doc)
final protected void disableEvents(long eventsToDisable)(Code)(Java Doc)
final public void dispatchEvent(AWTEvent e)(Code)(Java Doc)
void dispatchEventImpl(AWTEvent e)(Code)(Java Doc)
public void doLayout()(Code)(Java Doc)
public void enable()(Code)(Java Doc)
public void enable(boolean b)(Code)(Java Doc)
final protected synchronized void enableEvents(long eventsToEnable)(Code)(Java Doc)
boolean eventEnabled(AWTEvent e)(Code)(Java Doc)
Component findFocusDelegate(Container container)(Code)(Java Doc)
public float getAlignmentX()(Code)(Java Doc)
public float getAlignmentY()(Code)(Java Doc)
public Color getBackground()(Code)(Java Doc)
public Rectangle getBounds()(Code)(Java Doc)
public ColorModel getColorModel()(Code)(Java Doc)
public Component getComponentAt(int x, int y)(Code)(Java Doc)
public Component getComponentAt(Point p)(Code)(Java Doc)
public Cursor getCursor()(Code)(Java Doc)
Component getFocusDelegate()(Code)(Java Doc)
public Font getFont()(Code)(Java Doc)
Component getFontAndColorDelegate()(Code)(Java Doc)
public FontMetrics getFontMetrics(Font font)(Code)(Java Doc)
public Color getForeground()(Code)(Java Doc)
public Graphics getGraphics()(Code)(Java Doc)
InputContext getInputContext()(Code)(Java Doc)
public Locale getLocale()(Code)(Java Doc)
public Point getLocation()(Code)(Java Doc)
public Point getLocationOnScreen()(Code)(Java Doc)
public Dimension getMaximumSize()(Code)(Java Doc)
public Dimension getMinimumSize()(Code)(Java Doc)
public String getName()(Code)(Java Doc)
Container getNativeContainer()(Code)(Java Doc)
public Container getParent()(Code)(Java Doc)
public Dimension getPreferredSize()(Code)(Java Doc)
public Dimension getSize()(Code)(Java Doc)
public Toolkit getToolkit()(Code)(Java Doc)
final public Object getTreeLock()(Code)(Java Doc)
public boolean gotFocus(Event evt, Object what)(Code)(Java Doc)
public boolean handleEvent(Event evt)(Code)(Java Doc)
public void hide()(Code)(Java Doc)
public boolean imageUpdate(Image img, int flags, int x, int y, int w, int h)(Code)(Java Doc)
public boolean inside(int x, int y)(Code)(Java Doc)
public void invalidate()(Code)(Java Doc)
static void invokeAndWait(Runnable runnable)(Code)(Java Doc)
public boolean isDisplayable()(Code)(Java Doc)
public boolean isEnabled()(Code)(Java Doc)
public boolean isFocusTraversable()(Code)(Java Doc)
public boolean isLightweight()(Code)(Java Doc)
boolean isLightweightWhenDisplayable()(Code)(Java Doc)
public boolean isOpaque()(Code)(Java Doc)
public boolean isShowing()(Code)(Java Doc)
public boolean isValid()(Code)(Java Doc)
public boolean isVisible()(Code)(Java Doc)
public boolean keyDown(Event evt, int key)(Code)(Java Doc)
public boolean keyUp(Event evt, int key)(Code)(Java Doc)
public void layout()(Code)(Java Doc)
void lightweightPrint(Graphics g)(Code)(Java Doc)
public void list()(Code)(Java Doc)
public void list(PrintStream out)(Code)(Java Doc)
public void list(PrintStream out, int indent)(Code)(Java Doc)
public void list(PrintWriter out)(Code)(Java Doc)
public void list(PrintWriter out, int indent)(Code)(Java Doc)
public Component locate(int x, int y)(Code)(Java Doc)
public Point location()(Code)(Java Doc)
public boolean lostFocus(Event evt, Object what)(Code)(Java Doc)
public Dimension minimumSize()(Code)(Java Doc)
public boolean mouseDown(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseDrag(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseEnter(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseExit(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseMove(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseUp(Event evt, int x, int y)(Code)(Java Doc)
public void move(int x, int y)(Code)(Java Doc)
public void nextFocus()(Code)(Java Doc)
public void paint(Graphics g)(Code)(Java Doc)
public void paintAll(Graphics g)(Code)(Java Doc)
protected String paramString()(Code)(Java Doc)
public boolean postEvent(Event e)(Code)(Java Doc)
public Dimension preferredSize()(Code)(Java Doc)
public boolean prepareImage(Image image, ImageObserver observer)(Code)(Java Doc)
public boolean prepareImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc)
public void print(Graphics g)(Code)(Java Doc)
public void printAll(Graphics g)(Code)(Java Doc)
protected void processComponentEvent(ComponentEvent e)(Code)(Java Doc)
protected void processEvent(AWTEvent e)(Code)(Java Doc)
protected void processFocusEvent(FocusEvent e)(Code)(Java Doc)
protected void processKeyEvent(KeyEvent e)(Code)(Java Doc)
protected void processMouseEvent(MouseEvent e)(Code)(Java Doc)
protected void processMouseMotionEvent(MouseEvent e)(Code)(Java Doc)
public synchronized void remove(MenuComponent popup)(Code)(Java Doc)
public synchronized void removeComponentListener(ComponentListener l)(Code)(Java Doc)
public synchronized void removeFocusListener(FocusListener l)(Code)(Java Doc)
public synchronized void removeKeyListener(KeyListener l)(Code)(Java Doc)
public synchronized void removeMouseListener(MouseListener l)(Code)(Java Doc)
public synchronized void removeMouseMotionListener(MouseMotionListener l)(Code)(Java Doc)
public void removeNotify()(Code)(Java Doc)
public void repaint()(Code)(Java Doc)
public void repaint(long tm)(Code)(Java Doc)
public void repaint(int x, int y, int width, int height)(Code)(Java Doc)
public void repaint(long tm, int x, int y, int width, int height)(Code)(Java Doc)
public void requestFocus()(Code)(Java Doc)
public void reshape(int x, int y, int width, int height)(Code)(Java Doc)
public void resize(int width, int height)(Code)(Java Doc)
public void resize(Dimension d)(Code)(Java Doc)
public void setBackground(Color c)(Code)(Java Doc)
public void setBounds(int x, int y, int width, int height)(Code)(Java Doc)
public void setBounds(Rectangle r)(Code)(Java Doc)
public synchronized void setCursor(Cursor cursor)(Code)(Java Doc)
public void setEnabled(boolean b)(Code)(Java Doc)
public void setFont(Font f)(Code)(Java Doc)
public void setForeground(Color c)(Code)(Java Doc)
public void setLocale(Locale l)(Code)(Java Doc)
public void setLocation(int x, int y)(Code)(Java Doc)
public void setLocation(Point p)(Code)(Java Doc)
public void setName(String name)(Code)(Java Doc)
public void setSize(int width, int height)(Code)(Java Doc)
public void setSize(Dimension d)(Code)(Java Doc)
public void setVisible(boolean b)(Code)(Java Doc)
public void show()(Code)(Java Doc)
public void show(boolean b)(Code)(Java Doc)
public Dimension size()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
public void transferFocus()(Code)(Java Doc)
public void update(Graphics g)(Code)(Java Doc)
public void validate()(Code)(Java Doc)

Methods inherited from java.lang.Object
public boolean equals(Object obj)(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.