15.11 Horizontale und vertikale Schieberegler 

Ein Schieberegler (engl. scrollbar, auch Rollbalken 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 Schieberegler 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 Schieberegler liegt oben der größte Wert und bei einem horizontalen auf der linken Seite. Wird der Schieberegler 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 Schieberegler

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 Schieberegler 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
{
  static JTextField tf;
  static JScrollBar sb;

  public static void main( String args[] )
  {
    JFrame f = new JFrame();
    f.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );

    Container c = f.getContentPane();

    c.setLayout( new GridLayout(2,1) );

    c.add ( tf = new JTextField( 20 ) );
    c.add ( sb = new JScrollBar( JScrollBar.HORIZONTAL, 50, 10, 0, 100+10 ) );

    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 );
  }
}

class javax.swing.  JScrollBar  
extends JComponent
implements Adjustable, Accessible

JScrollBar() Erzeugt einen vertikalen Schieberegler.

JScrollBar( int orientation ) Erzeugt einen neuen Schieberegler mit der angegebenen Richtung.

JScrollBar( int orientation, int value, int extent, int minimum, int maximum ) Erzeugt einen neuen Schieberegler mit der angegebenen Richtung. Zudem wird der Initialwert, die Größe, Minimum und Maximum gesetzt. Die Eigenschaften minimum und maximum geben die Grenzen des Werts an, die der Schieberegler 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 Schiebereglers. 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 Schieberegler steht der Knopf unten und bei einem horizontalen Schieberegler 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 unter Windows die Schieber nicht proportional zur Größe des darstellenden Inhalts sind, lässt sich hier einfach ein proportionaler Schieberegler 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 Schiebereglers (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 Schiebereglers.

void setOrientation( int orientation ) Setzt die Orientierung neu.

int getMaximum(), getMinimum() Liefert das Maximum beziehungsweise Minimum des Schiebereglers.

void setMaximum( int newMaximum ), void setMinimum( int newMinimum ) Setzt den maximalen beziehungsweise minimalen anzunehmenden Wert des Schiebereglers.

int getValue() Liefert den aktuellen Wert des Schiebereglers.

void setValue( int newValue ) Setzt einen neuen Wert.

int getBlockIncrement() Liefert die Blockschrittweite vom Schieberegler. 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 Schieberegler.

int getUnitIncrement() Liefert die Schrittweite des Schiebereglers, die bestimmt, wie weit die aktuelle Seite weitergeblättert wird, wenn die Pfeile des Schiebereglers 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 Schiebereglers.

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 Schieberegler registrieren.

interface java.awt.event.  AdjustmentListener  
extends EventListener

void adjustmentValueChanged( AdjustmentEvent e ) Wird vom Schieberegler 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

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() );
}