15.11 Horizontale und vertikale Rollbalken
 
Ein Rollbalken (engl. scrollbar, auch Schieberegler bzw. Bildlaufleiste genannt) ist eine grafische Benutzerschnittstelle, die es einem Benutzer auf einfache Weise ermöglicht, einen ganzzahligen Wert aus einem vorher festgelegten Wertebereich auszuwählen. Der Rollbalken kann vertikal oder horizontal angeordnet werden. Mittels eines verschiebbaren Knopfes lässt sich ein Wert auswählen. Er besitzt für Verschiebungen folgende Regel hinsichtlich des internen Werts: Bei einem vertikalen Rollbalken liegt oben der größte Wert und bei einem horizontalen auf der linken Seite. Wird der Rollbalken verändert, werden AdjustmentEvent-Objekte erzeugt. JScrollBar ist das leichtgewichtige Pendant zu AWT Scrollbar. Dem JScrollBar ist ein BoundedRangeModel zugewiesen, welches die Daten speichert.
 Hier klicken, um das Bild zu Vergrößern
Abbildung 15.11
Ein Rollbalken
Das folgende Programm verwendet ein JScrollBar- und ein JTextField-Objekt. Beide benachrichtigen sich bei Änderungen. Wird also im Textfeld eine neue Zahl eingesetzt, zeigt der Rollbalken diese an. Verändern wir den Regler, so wird die passende Zahl in das Textfeld gesetzt. Sie werden mit Listener-Objekten betrieben.
Listing 15.17
JScrollBarDemo.java
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
public class JScrollBarDemo
{
public static void main( String[] args )
{
JFrame f = new JFrame();
f.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
f.setLayout( new GridLayout(2, 1) );
final JTextField tf = new JTextField( 20 );
final JScrollBar sb = new JScrollBar( Adjustable.HORIZONTAL, 50, 10, 0, 100 + 10 );
f.add ( tf );
f.add ( sb );
tf.addActionListener( new ActionListener() {
public void actionPerformed( ActionEvent e ) {
sb.setValue( Integer.parseInt(tf.getText()) );
}
} );
sb.addAdjustmentListener( new AdjustmentListener() {
public void adjustmentValueChanged( AdjustmentEvent e ) {
tf.setText( "" + sb.getValue() );
}
} );
f.pack();
f.setVisible( true );
}
}
Die wichtigen Properties einer JScrollBar sind: Orientierung (horizontal, vertikal), Minimalwert, Maximalwert, aktueller Wert. Für die Orientierung sind zwei Konstanten in der Schnittstelle java.awt.Adjustable definiert; die JScrollBar implementiert HORIZONTAL und VERTICAL. Ein Rollbalken kann immer nur eines von beiden sein. Das Minimum steht standardmäßig auf 0 und das Maximum auf 100.
class javax.swing. JScrollBar
extends JComponent
implements Adjustable, Accessible
|
|
JScrollBar()
Erzeugt einen vertikalen Rollbalken. |
|
JScrollBar( int orientation )
Erzeugt einen neuen Rollbalken mit der angegebenen Richtung. |
|
JScrollBar( int orientation, int value, int extent, int minimum, int maximum )
Erzeugt einen neuen Rollbalken mit der angegebenen Richtung. Zudem werden der Initialwert, die Größe, Minimum und Maximum gesetzt. Die Eigenschaften minimum und maximum geben die Grenzen des Werts an, die der Rollbalken annehmen kann. Geben wir maximum kleiner oder gleich minimum an, dann wird maximum = minimum + 1 gesetzt. Der weitere zusätzliche Parameter value bestimmt den Startwert des Rollbalkens. value darf nicht kleiner als minimum sein. Ist er es dennoch, so wird value = minimum gesetzt. Der value steht bei beiden auf 0, das heißt, bei einem vertikalen Rollbalken steht der Knopf unten und bei einem horizontalen Rollbalken links. Mit extent können wir die Größe des Schiebers bestimmen. Daneben hat extent aber noch eine andere Funktion, denn es bestimmt zusätzlich die Größe der Veränderung, wenn der Schieber bewegt wird – mit anderen Worten: die Schrittweite. Da die Schieber unter Windows nicht proportional zur Größe des darstellenden Inhalts sind, lässt sich hier einfach ein proportionaler Rollbalken implementieren. So können wir leicht von der Größe des Knopfs auf den Umfang schließen. Der Wert von extent muss kleiner sein als der Wertebereich des Rollbalkens (extent <= maximum – minimum). Verstößt visible gegen die einfache Gleichung, wird visible = maximum – minimum gewählt. Erreicht extent einen Wert kleiner 1, wird dieser zurück auf 1 gesetzt. Für die beiden anderen Konstruktoren ist der Wert von extent auf 10 festgelegt. |
|
int getOrientation()
Liefert die Orientierung des Rollbalkens. |
|
void setOrientation( int orientation )
Setzt die Orientierung neu. |
|
int getMaximum(), getMinimum()
Liefert das Maximum beziehungsweise Minimum des Rollbalkens. |
|
void setMaximum( int newMaximum ), void setMinimum( int newMinimum )
Setzt den maximalen beziehungsweise minimalen anzunehmenden Wert des Rollbalkens. |
|
int getValue()
Liefert den aktuellen Wert des Rollbalkens. |
|
void setValue( int newValue )
Setzt einen neuen Wert. |
|
int getBlockIncrement()
Liefert die Blockschrittweite vom Rollbalken. Diese definiert beim Druck auf die Bildlaufleiste (nicht Pfeile), um wie viele Zeilen weitergeblättert wird. Im Allgemeinen führt ein Druck auf die Bild-runter-Taste zu demselben Effekt. |
|
void setBlockIncrement( int v )
Setzt die Blockschrittweite für den Rollbalken. |
|
int getUnitIncrement()
Liefert die Schrittweite des Rollbalkens, die bestimmt, wie weit die aktuelle Seite weitergeblättert wird, wenn die Pfeile des Rollbalkens angewählt werden. Die Operation ist vergleichbar mit einem Druck auf die Hoch/Runter-Pfeiltasten. |
|
void setUnitIncrement( int v )
Setzt die Schrittweite neu. |
|
int getVisibleAmount()
Liefert die Größe des sichtbaren Bereichs. |
|
void setVisibleAmount( int extent )
Setzt eine neue Größe des sichtbaren Bereichs. |
|
void setValues( int newValue, int newExtent, int newMin, int newMax )
Setzt die vier Eigenschaften des Rollbalkens. |
|
void addAdjustmentListener( AdjustmentListener l )
Fügt einen AdjustmentListener hinzu, der AdjustmentEvent auffängt. |
|
void removeAdjustmentListener( AdjustmentListener l )
Entfernt den AdjustmentListener wieder. |
15.11.1 Der AdjustmentListener, der auf Änderungen hört
 
Objekte, die an Änderungen interessiert sind, müssen die Schnittstelle AdjustmentListener implementieren und sich beim jeweiligen Rollbalken registrieren.
interface java.awt.event. AdjustmentListener
extends EventListener
|
|
void adjustmentValueChanged( AdjustmentEvent e )
Wird vom Rollbalken aufgerufen, wenn das Objekt seinen Wert verändert. |
Das AdjustmentEvent verrät uns, welches Ereignis zu der Veränderung geführt hat.
class java.awt. AdjustmentEvent
extends AWTEvent
|
|
Adjustable getAdjustable()
Gibt das Adjustable-Objekt zurück, bei dem das Event auftrat. |
|
int getValue()
Gibt den Wert im Adjustment-Objekt zurück. |
|
int getAdjustmentType()
Gibt eine der Konstanten UNIT_INCREMENT, UNIT_DECREMENT, BLOCK_INCREMENT, BLOCK_DECREMENT oder TRACK zurück, die den Typ des Ereignisses beschreiben. |
 Hier klicken, um das Bild zu Vergrößern
Beispiel Wir beschreiben im folgenden Programmlisting einen AdjustmentListener, der alle möglichen Informationen über die Bewegung des Rollbalkens protokolliert.
|
public void adjustmentValueChanged( AdjustmentEvent event )
{
Adjustable sb = event.getAdjustable();
if ( sb.getOrientation() == Scrollbar.HORIZONTAL )
System.out.println( "Horizontal" );
else
System.out.println( "Vertikal" );
switch ( event.getAdjustmentType() )
{
case AdjustmentEvent.UNIT_INCREMENT:
System.out.println( "AdjustmentEvent.UNIT_INCREMENT" );
break;
case AdjustmentEvent.UNIT_DECREMENT:
System.out.println( "AdjustmentEvent.UNIT_DECREMENT" );
break;
case AdjustmentEvent.BLOCK_DECREMENT:
System.out.println( "AdjustmentEvent.BLOCK_DECREMENT" );
break;
case AdjustmentEvent.BLOCK_INCREMENT:
System.out.println( "AdjustmentEvent.BLOCK_INCREMENT" );
break;
case AdjustmentEvent.TRACK:
System.out.println( "AdjustmentEvent.TRACK" );
break;
}
System.out.println( " value: " + event.getValue() );
}
|