Advanced   Java   Services

Scrollbar

Scrollbar

Ein Scrollbalken ist ein Schieberegler, der über den Konstruktor oder auch später waagrecht oder senkrecht gewählt werden kann. Die Wirkung des Defaultkonstruktor ist aus der folgenden Tabelle ersichtlich.

Die Wirkung von Cursor up/down kan man mit setUnitIncrement(int v) individuell verändern.
Die Wirkung von Page up/down kann man mit setBlockIncrement(int v) individuell verändern.
Die Größe des Schiebereglers selbst setzt man mit setVisibleAmount(int newAmount) .

Der regelbare Bereich

In der Grundeinstellung liefert getMinimum() wie zu erwarten 0, getMaximum() dagegen liefert 100, getVisibleAmount() liefert 10 . Der regelbare Bereich berechnet sich also folgendermaßen

regelbarer Bereich = Minimum bis (Maximum - VisibleAmount)

Hierzu noch ein Beispiel. Wir wollen einen Temperaturregler, der von -273 Grad Celsius bis 100 Grad Celsius reicht. Die Anfangsposition soll bei 0 Grad liegen und der Schieberegler selbst soll 10 Einheiten groß werden. Dies erreicht man durch den folgenden Konstruktoraufruf:

// Scrollbar(int orientation, int value, int visible, int minimum, int maximum)
Scrollbar sb = new Scrollbar(Scrollbar.HORIZONTAL, 0, 10, -273, 110) ;

Auszug aus der API:

Konstanten
Typ	Name der Konstante
static int	HORIZONTAL constant that indicates a horizontal scroll bar.
static int	VERTICAL A constant that indicates a vertical scroll bar.

Konstruktoren
Scrollbar()	Constructs a new vertical scroll bar.
Scrollbar(int orientation)	Constructs a new scroll bar with the specified orientation.
Scrollbar(int orientation, int value, int visible, int minimum, int maximum)	Constructs a new scroll bar with the specified orientation, initial value, visible amount, and minimum and maximum values.

Methoden
Returntyp	Name der Methode
Eventhandling
void	addAdjustmentListener(AdjustmentListener l) Adds the specified adjustment listener to receive instances of AdjustmentEvent from this scroll bar.
void	removeAdjustmentListener(AdjustmentListener l) Removes the specified adjustment listener so that it no longer receives instances of AdjustmentEvent from this scroll bar.
AdjustmentListener[]	getAdjustmentListeners() Returns an array of all the adjustment listeners registered on this scrollbar.
weitere Methoden
int	getBlockIncrement() Gets the block increment of this scroll bar.
void	setBlockIncrement(int v) Sets the block increment for this scroll bar.
int	getUnitIncrement() Gets the unit increment for this scrollbar.
void	setUnitIncrement(int v) Sets the unit increment for this scroll bar.
int	getMaximum() Gets the maximum value of this scroll bar.
void	setMaximum(int newMaximum) Sets the maximum value of this scroll bar.
int	getMinimum() Gets the minimum value of this scroll bar.
void	setMinimum(int newMinimum) Sets the minimum value of this scroll bar.
int	getOrientation() Returns the orientation of this scroll bar.
void	setOrientation(int orientation) Sets the orientation for this scroll bar.
int	getValue() Gets the current value of this scroll bar.
void	setValue(int newValue) Sets the value of this scroll bar to the specified value.
boolean	getValueIsAdjusting() Returns true if the value is in the process of changing as a result of actions being taken by the user.
void	setValueIsAdjusting(boolean b) Sets the valueIsAdjusting property.
int	getVisibleAmount() Gets the visible amount of this scroll bar.
void	setVisibleAmount(int newAmount) Sets the visible amount of this scroll bar.