JAVA - Graphische Komponenten - Scrollbar
Startseite  Graphische Komponenten  Indexverzeichnis	JAVA - Graphische Komponenten - Scrollbar Constructor Methoden Indexvariablen Vererbung Beispiel

Constructor

public Scrollbar()	Erzeugt eine neue vertikale Scrollbar/Bildlaufleiste. Die Standardwerte kann man aus der nachfolgenden Tabelle entnehmen. Eigenschaft Beschreibung Standardwert Ausrichtung bestimmt, ob die Scrollbar horizontal oder vertikal ausgerichtet ist Scrollbar.VERTICAL Wert Wert, welcher die Position der Scrollbar bestimmt (Kasten, auf der Bildlaufleiste) 0 minimum Minimaler Wert der Scrollbar 0 maximum Maximaler Wert der Scrollbar 100 Schrittweite Anzahl der Schritte, die weitergeblättert wird, wenn auf die Pfeile der Scrollbar geklickt wird. 1 Blockschrittweite Anzahl der Schritte, wenn auf die Scrollbar geklickt wird (nicht auf die Pfeile und nicht auf den "Kasten" 10
public Scrollbar(int orientation)	Erzeugt eine neue Scrollbar/Bildlaufleiste mit der angegebenen Ausrichtung. Die Ausrichtung kann vertikal (Scrollbar.VERTICAL) oder horizontal (Scrollbar.HORIZONTAL) sein. Parameter: orientation - Ausrichtung Exception: IllegalArgumentException - wenn ein ungültiger Wert angegeben wird
public Scrollbar(int orientation,int value,int visible,int minimum, int maximum)	Erzeugt eine neue Scrollbar/Bildlaufleiste mit der angegebenen Ausrichtung, Startwert, der Größe und den minimum- und maximum-Werten. Die Ausrichtung kann vertikal (Scrollbar.VERTICAL) oder horizontal (Scrollbar.HORIZONTAL) sein. Sollte der maximum-Wert kleiner als der minimum-Wert sein, so wird dieser auf den selben Wert gestellt, wie der minimum-Wert. Ebenso erfolgt es beim Startwert. Wenn er kleiner ist als der minimum-Wert, wird auf auf den gleichen Wert eingestellt. Wenn der Startwert größer als der Maximum-Wert ist, wird er entsprechend niedriger eingestellt. Parameter: orientation - Ausrichtung der Scrollbar value - Startwert der Scrollbar visible - Größe der Scrollbar-"Kastens", der den gerade sichtbaren Teil des Gesamtdokuments anzeigt minimum - Minimumwert der Scrollbar maximum - Maximumwert der Scrollbar

Methoden

public void addAdjustmentListener(AdjustmentListener l)	Fügt einen AdjustmentListener zur Scrollbar hinzu, um Ereignisse auswerten zu können. Wenn l Null ist, werden keine Exceptions verarbeitet und nichts ausgeführt. definiert durch: addAdjustmentListener im Interface java.awt.Adjustable Parameter: l AdjustmentListener
public void addNotify()	Erzeugt ein Handle auf die Scrollbar. Dieses Handle ermöglicht es, das Aussehen der Scrollbar zu ändern, ohne ihre Funktionalität zu ändern. Überschreibt: addNotify in der Klasse java.awt.Component
public int getBlockIncrement()	Gibt die Blockschrittweite zurück. Diese gibt an, wieviel von der aktuellen Seite weitergeblättert wird, wenn auf die Bildlaufleiste geklickt wird (nicht auf die Pfeile). Die selbe Funktion wird in vielen Programmen durch die "Bild-runter-Taste" unterstützt. definiert durch: getBlockIncrement im Interface java.awt.Adjustable
public int getLineIncrement()	Deprecated = nicht mehr gültig. Wurde ersetzt durch getUnitIncrement().
public int getMaximum()	Gibt den Maximum-Wert der Scrollbar zurück. beschrieben durch: getMaximum im Interface java.awt.Adjustable Rückgabe: Maximum-Wert der Scrollbar
public int getMinimum()	Gibt den Minimum-Wert der Scrollbar zurück. beschrieben durch: getMinimum im Interface java.awt.Adjustable Rückgabe: Minimum-Wert der Scrollbar
public int getOrientation()	Gibt die Ausrichtung der Scrollbar zurück. beschrieben durch: getOrientation im Interface java.awt.Adjustable Rückgabe: Ausrichtung der Scrollbar, entweder Scrollbar.HORIZONTAL oder Scrollbar.VERTICAL
public int getPageIncrement()	Deprecated = nicht mehr gültig. Wurde ersetzt durch getBlockIncrement().
public int getUnitIncrement()	Gibt die Schrittweite der Srollbar zurück. Die Schrittweite bestimmt, wie weit die aktuelle Seite weitergeblättert wird, wenn auf die Pfeile der Scrollbar geklickt wird. Vergleichbar ist dies mit den Pfeil-Tasten der Tastatur (hoch/runter). beschrieben durch: getUnitIncrement im Interface java.awt.Adjustable Rückgabe: - Schrittweite der Scrollbar
public int getValue()	Gibt den aktuellen Wert der Scrollbar(-Position) zurück. beschrieben durch: getValue im Interface java.awt.Adjustable Rückgabe: Aktuellen Wert der Scrollbar
public int getVisible()	Deprecated = nicht mehr gültig. Wurde ersetzt durch getVisibleAmount().
public int getVisibleAmount()	Gibt zurück, wieviel der Seite sichtbar ist. beschrieben durch: getVisibleAmount im Interface java.awt.Adjustable Rückgabe: sichtbaren Bereich der Scrollbar
protected String paramString()	Gibt den String zurück, der der Status der Scrollbar beschreibt. Dieser String ist für den Debugger nützlich. Rückgabe: Parameter-String der Scrollbar Überschreibt: Methode paramString der Klasse java.awt.Component
protected void processAdjustmentEvent(AdjustmentEvent e)	Verarbeitet AdjustmentEvents der Scrollbar, indem die Komponente an einen registrierten AdjustmentListner weitergeleitet wird. Diese Methode wird nur aufgerufen, wenn AdjustmentEvents für diese Scrollbar zugelassen wurden. AdjustmentEvents sind zugelassen wenn: - ein AdjustmentListener mit addAdjustmentListener hinzugefügt wurde - AdjustmentEvents mit der Methode enableEvents zugelassen wurden. Parameter: e - AdjustmentEvent
protected void processEvent(AWTEvent e)	Verarbeitet Ereignisse der Scrollbar. Wenn das Ereignis eine Instanz eines AdjustmentEvent ist, ruft diese Methode die Methode processAdjustmentEvent auf. Ansonsten ruft es die Methode processEvent der Superklasse auf. Parameter: e - Ereignis Überschreibt: Methode processEvent der Klasse java.awt.Component
public void removeAdjustmentListener(AdjustmentListener l)	Entfernt den AdjustmentListener, so daß er nicht länger Ereignisse der Scrollbar verarbeitet. Wenn l Null ist, wird kein Exception verarbeitet und nichts ausgeführt. beschrieben durch: removeAdjustmentListener im Interface java.awt.Adjustable Parameter: l - AdjustmentListener
public void setBlockIncrement(int v)	Setzt die Blockschrittweite. Diese gibt an, wieviel von der aktuellen Seite weitergeblättert wird, wenn auf die Bildlaufleiste geklickt wird (nicht auf die Pfeile). Die selbe Funktion wird in vielen Programmen durch die "Bild-runter-Taste" unterstützt. beschrieben durch: setBlockIncrement im Interface java.awt.Adjustable Parameter: v - Bereich, um welchen der sichtbare Bereich der Scrollbar erhöht bzw. verringert werden soll.
public void setLineIncrement(int v)	Deprecated = nicht mehr gültig. Wurde ersetzt durch setUnitIncrement(int).
public void setMaximum(int newMaximum)	Legt den maximalen Wert der Scrollbar neu fest. Normalerweise sollte ein Programm den Maximum-Wert nur über die Methode setValues ändern. Diese Methode setzt den miminum- und maximum-Wert sowie den Sichtbaren Bereich und Wert gleichzeitig und stimmt sie aufeinander ab, daß es keine Widersprüche zwischen ihnen gibt. beschrieben durch: setMaximum im Interface java.awt.Adjustable Parameter: newMaximum - neuer Maximum-Wert der Scrollbar
public void setMinimum(int newMinimum)	Legt den minimalen Wert der Scrollbar neu fest. Normalerweise sollte ein Programm den Minimum-Wert nur über die Methode setValues ändern. Diese Methode setzt den miminum- und maximum-Wert sowie den Sichtbaren Bereich und Wert gleichzeitig und stimmt sie aufeinander ab, daß es keine Widersprüche zwischen ihnen gibt. beschrieben durch: setMinimum im Interface java.awt.Adjustable Parameter: newMinimum - neuer Maximum-Wert der Scrollbar
public void setOrientation(int orientation)	Legt die Ausrichtung des Scrollbar neu fest. Parameter: orientation - Ausrichtung der Scrollbar, entweder Scrollbar.HORIZONTAL oder Scrollbar.VERTICAL Exception: IllegalArgumentException - wenn ein ungültiger Wert verwendet wird.
public void setPageIncrement(int v)	Deprecated = nicht mehr gültig. Wurde ersetzt durch setBlockIncrement().
public void setUnitIncrement(int v)	Legt die Schrittweite der Srollbar fest. Die Schrittweite bestimmt, wie weit die aktuelle Seite weitergeblättert wird, wenn auf die Pfeile der Scrollbar geklickt wird. Vergleichbar ist dies mit den Pfeil-Tasten der Tastatur (hoch/runter). beschrieben durch: setUnitIncrement im Interface java.awt.Adjustable Parameter: v - Bereich, um den erhöht bzw. verringert werden soll
public void setValue(int newValue)	Legt den Wert der Scrollbar neu fest. Wenn der Wert kleiner als der Minimum-Wert bzw. größer als der Maximum-Wert ist, wird er entsprechend angepaßt. Normalerweise sollte ein Programm den Minimum-Wert nur über die Methode setValues ändern. Diese Methode setzt den miminum- und maximum-Wert sowie den Sichtbaren Bereich und Wert gleichzeitig und stimmt sie aufeinander ab, daß es keine Widersprüche zwischen ihnen gibt. beschrieben durch: setValue im Interface java.awt.Adjustable Parameter: newValue - neuer Wert der Scrollbar
public void setValues(int value,int visible,int minimum, int maximum)	Legt die vier angegebenen Werte neu fest. Diese Methode synchronisiert die Werte so, daß sie zusammenpassen, d.h. der Wert value darf nicht kleiner als der minimum- und nicht größer als der maximum-Wert sein. Parameter: value - aktuelle Position visible - Größe der Scrollbar-"Kastens", der den gerade sichtbaren Teil des Gesamtdokuments anzeigt minimum - Minimumwert der Scrollbar maximum - Maximumwert der Scrollbar
public void setVisibleAmount(int newAmount)	Legt fest, welcher Bereich der aktuellen Seite sichtbar sein soll. Normalerweise sollte ein Programm den Minimum-Wert nur über die Methode setValues ändern. Diese Methode setzt den miminum- und maximum-Wert sowie den Sichtbaren Bereich und Wert gleichzeitig und stimmt sie aufeinander ab, daß es keine Widersprüche zwischen ihnen gibt. beschrieben durch: setVisibleAmount im Interface java.awt.Adjustable Parameter: newAmount - neuer sichtbarer Bereich der Scrollbar

Indexvariablen

public static final int HORIZONTAL	horizontale Scrollbar/Bildlaufleiste
public static final int VERTICAL	vertikale Scrollbar/Bildlaufleiste

Vererbung

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Scrollbar

Beispiel

Programmbeispiel:

import java.applet.*; import java.awt.*; public class Scrollbar2 extends Applet { public void init(){ Scrollbar sb1 = new Scrollbar(1); Scrollbar sb2 = new Scrollbar(0,5,20,0,50); add(sb1); add(sb2); } }

Die Klasse java.awt.Scrollbar besitzt drei Constructors.

Der erste ist in meinem Programm nicht aufgeführt. Die Standardeinstellungen könnt ihr aus der Constructordefinition entnehmen. Der zweite erlaubt nur, die Ausrichtung (horizontal - 0 oder vertikal - 1) anzugeben.

Mit dem dritten kann man außerdem den Positions-Startwert festlegen, wo sie sich beim ersten Aufruf einstellen soll. Der dritte Parameter legt fest, wieviel des Gesamtdokuments sichtbar sein soll. Mit den letzten beiden Werten wird noch die Scala der Bildlaufleiste festgelegt, in unserem Beispiel von 0 bis 50.

Wenn ihr die beiden Scrollbars im Beispiel bewegt, werdet ihr den Unterschied sehen.

weiter: zurück:

Layoutmanager-Grundlagen   TextField

© 1999-2001  Brit Schröter