15.9 Container 
Alle Komponenten müssen auf einen Container platziert werden. Container sind besondere Swing-Elemente, die dazu dienen, andere Kinder aufzunehmen und zu verwalten. Zu den wichtigsten Containern in Swing zählen:
- JPanel. Ist im Wesentlichen eine JComponent mit der Möglichkeit, Kinder nach einem bestimmten Layoutverfahren anzuordnen.
- JScrollPane. Kann Bereiche einer sehr großen Komponente mit Rollbalken anzeigen. Das ist von der Textverarbeitung bekannt, wenn der Text sehr lang ist, aber der Bildschirm viel kleiner.
- JTabbedPane. Zeigt Reiter in einem Karteikasten an.
- JSplitPane. Ermöglicht die Darstellung zweier Komponenten über- oder nebeneinander, wobei ein so genannter Divider eine Größenveränderung erlaubt.
Dazu kommen noch Container wie die JToolBar, Layered Pane oder Root Pane, die wir uns für später aufschieben.
15.9.1 Standardcontainer (JPanel) 
Ein wichtiger Container unter Swing ist JPanel. Der zwischen einem Toplevel-Container wie JFrame und den Komponenten liegende Container (engl. intermediate container) erlaubt Doppel-Pufferung (engl. double buffering). Ist diese Pufferung eingeschaltet, werden alle Zeichenoperationen von Komponenten auf dem Panel auf einem Hintergrundbild (engl. offscreen image) ausgeführt und zu einem gewählten Zeitpunkt in den Vordergrund geschoben. Die Möglichkeit der Doppelpufferung lässt sich durch den Konstruktor setzen oder über die Methode setBuffered().
Die Klasse JPanel wird von uns in vielen Beispielen eingesetzt, dort aber lediglich als Container-Objekt. Neben den geerbten Funktionen von JComponent, Container, Component und natürlich Object kommen keine nennenswerten Funktionen hinzu.
class javax.swing.JPanel
extends JComponent
implements Accessible |
- JPanel() Erzeugt ein neues JPanel mit Doppelpufferung und einem Flow-Layout.
- JPanel( boolean isDoubleBuffered ) Erzeugt ein neues JPanel mit Flow-Layout und der angegebenen Puffer-Strategie.
Sehr wichtig wird das JPanel zur Gruppierung von Elementen.
15.9.2 Bereich mit automatischen Rollbalken (JScrollPane)
Die JScrollPane ermöglicht die Anzeige von Bereichen einer sehr großen Fläche. Rollbalken (JScrollBar-Objekte) synchronisieren automatisch den ausgewählten Bereich. Ob Rollbalken auch dann angezeigt werden sollen, wenn genug Platz ist, bestimmen Konstanten, die dem Konstruktor von JScrollPane übergeben werden.
|
JScrollPane scrollPane = new JScrollPane( JScrollPane.VERTICAL_SCROLLBAR_ALWAYS,
JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS );
scrollPane.setViewportView( componentToScroll );Die zu ummantelnde Komponente lässt sich auch im Konstruktor angeben. Die Container-Funktion add() ist nicht geeignet! |
Beispiel Der Viewport
Den sichtbaren Ausschnitt der Fläche bestimmt ein JViewport-Objekt, das mit zusätzlichen Listenern etwa für die Änderungen des sichtbaren Bereichs ausgestattet werden kann. Die Methode getViewport() liefert das JViewport-Objekt. Die Methoden scrollRectTo-Visible(Rectangle) und setViewPosition(Point) des JViewport-Objekts ermöglichen die Ansteuerung des sichtbaren Bereichs.
|
System.out.println( scrollPane.getViewport().getVisibleRect() ); Die JViewport-Methode getVisibleRect() stammt aus der direkten Oberklasse JComponent. Sie liefert ein Rectangle-Objekt, und getLocation() liefert den java.awt.Point vom Rechteck oben links. |
Jeweils auf die gegenüberliegende Seite der Rollbalken lassen sich Zeilen- und Spalten-Leisten legen, genauso wie in alle vier Ecken Komponenten. Die Leisten liegen selbst wiederum in einem JViewport, um zum Beispiel im Fall einer Linealbeschriftung mitzuwandern. setRowHeaderView(), setColumnHeaderView() und setCorner() setzen bei der JScrollPane die Ecken und Leisten.
Die Schnittstelle Scrollable
Die komplexen Komponenten wie Textanzeigefelder, Bäume oder Tabellen implementieren eine Verschiebefähigkeit nicht selbst, sondern müssen dazu in einer JScrollPane Platz nehmen. Damit JScrollPane jedoch weiß, wie zum Beispiel nach einem Klick auf den Bildlauf der Ausschnitt zu verändern ist, implementieren die Komponenten die Schnittstelle Scrollable. Die zentralen Klassen JList, JTable, JTextComponent und JTree implementieren die Schnittstelle und teilen auf diese Weise Ausmaße der Komponente und Anzahl der Pixel bei einer Verschiebung mit, wenn etwa der Anwender den Rollbalken um eine Position versetzt.
15.9.3 Reiter (JTabbedPane)
Eine JTabbedPane hat mehrere Reiter mit eingebetteten Komponenten, die sie automatisch bei Aktivierung anzeigt.
|
Listing 15.21 com/tutego/insel/ui/swing/JTabbedPaneDemo, Ausschnitt JTabbedPane tabbedPane = new JTabbedPane();
tabbedPane.addTab( "Reiter 1", new JButton("Reiter 1") );
tabbedPane.addTab( "Reiter 2", new JTextArea() ); |
Der Reiter kann nicht nur aus einem Titel bestehen, sondern kann zudem eine Grafik und einen Tooltip annehmen. Die Position der Reiteranzeigen bestimmen die Konstanten JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT und JTabbedPane.RIGHT, die entweder über den Konstruktor oder die Methode setTabPlacement() angegeben werden. Eine weitere Einstellung ist die Layout-Angabe, wenn der Container für den Reiter zu klein ist. Im Konstruktor oder über die Methode setTabLayoutPolicy() lassen sich angeben: JTabbedPane.WRAP_TAB_LAYOUT für den Umbruch, der üblicherweise Standard ist, oder JTabbedPane.SCROLL_TAB_LAYOUT, mit der kleine Schaltflächen zum Weitereschalten angezeigt werden.
class javax.swing.JTabbedPane
extends JComponent
implements Serializable, Accessible, SwingConstants |
- JTabbedPane() Erzeugt einen Karteikasten und positioniert die Reiter oben.
- JTabbedPane( int tabPlacement ) Erzeugt einen Karteikasten mit gewünschter Reiter-Positionierung.
- JTabbedPane( int tabPlacement, int tabLayoutPolicy ) Erzeugt einen Karteikasten mit gewünschter Reiter-Positionierung und Umbruch-Strategie.
- void addTab( String title, Component component )
- void addTab( String title, Icon icon, Component component )
- void addTab( String title, Icon icon, Component component, String tip ) Fügt eine Komponente als Karteikarte hinzu.
15.9.4 Teilung-Komponente (JSplitPane)
Die JSplitPane ist ein Container, der Komponenten nebeneinander (HORIZONTAL_SPLIT) oder übereinander (VERTICAL_SPLIT) anordnet. Eine Bewegung des Dividers führt zu unterschiedlichen Größen der Komponenten im Container. Die JSplitPane lässt sich schachteln, so dass etwa ein Hauptbereich in links/rechts unterteilt wird und der andere Teil wiederum eine JSplitPane enthält, die etwa oben/unten unterteilt.
Die Klasse JSplitPane verfügt über mehrere Konstruktoren:
class javax.swing.JSplitPane
extends JComponent
implements Accessible |
- JSplitPane()
- JSplitPane( int newOrientation )
- JSplitPane( int newOrientation, boolean newContinuousLayout )
- JSplitPane( int newOrientation, boolean newContinuousLayout, Component newLeftComponent, Component newRightComponent )
- JSplitPane( int newOrientation, Component newLeftComponent, Component newRightComponent )
Die Konstruktoren können die beiden Komponenten annehmen und auch die Orientierung. Nachträglich setzen die set[Top|Bottom|Left|Right]Component(Component) bzw. setOrientation() sie. Die Methode setContinuousLayout(boolean) bestimmt, ob die JSplitPane während des Verschiebens des Dividers den Inhalt aktualisiert oder erst am Ende. Die Methoden setDividerLocation(int) oder setDividerLocation(float) setzen das Verhältnis der beiden Komponenten in der JSplitPane. Im Fall von float ist die Angabe prozentual zwischen 0 und 1. Die Methode setOneTouchExpandable(boolean) bestimmt, ob kleine angezeigte Pfeile schnell die Anzeige zusammen- oder auffalten.