Swing

Swing ist eine Java-Bibliothek, mit der man Benutzeroberflächen bauen kann.

Es lohnt sich nicht mehr zu tief in Swing einzusteigen, weil es ab Java 1.8 die neue Bibliothek JavaFX gibt, die mehr Funktionalität hat (z.B. Integration von Stylesheets) und sich u.a. auch für die Entwicklung von Benutzeroberflächen für Apps eignet.

Allerdings ist Swing immer noch geeignet, wenn man mal "ganz schnell" eine grafische Oberfläche für ein Programm braucht!

Deswegen werden hier nur wenige wesentliche Elemente von Swing benannt.

Swing lässt sich am besten mit einem geeigneten Plugin entwickeln, z.B. dem WindowBuilder für Eclipse.

Container

In Container kann man andere Oberflächenelemente reinpacken. Sie brauchen deswegen ein definiertes Layout.

Man kann auch Container in andere Container packen (Ausnahme: JFrame).

• JFrame: Ein Fenster, das oben eine blaue Leiste hat für die Überschrift und das man schließen kann. Einen JFrame braucht man immer, weil JFrames selbstständig auf dem Bildschirm erscheinen können; alle anderen Elemente müssen in einen JFrame reingepackt werden.
• JPanel: Ein Container, der eigentlich unsichtbar ist; JPanel dienen dazu, andere Elemente zusammenzufassen.
• JScrollPane: Ein Container, der Scrollbars bereitstellt, wenn der Inhalt zu groß ist, um ihn ganz im Container darzustellen.

wichtige Methoden

• add(...): fügt ein Element hinzu.
• remove(...): entfernt ein Element.
• removeAll(): entfernt alle Elemente.
• setSize(int width, int height)
• revalidate() : wenn man dem Container ein neues Element hinzugefügt hat, dann muss man diese Methode aufrufen, damit der Container seine Größe anpasst. Am besten ruft man direkt danach repaint() (s.u.) auf.
• repaint() : sorgt dafür, dass der Container neu gezeichnet wird.
• setVisible(boolean pVisible)
• setLayout(...); z.B. setLayout(new BorderLayout());
• für JFrame: getContentPane(): gibt den eigentlichen Inhalt des JFrame zurück.
• für JFrame: setContentPane(...): Platziert ein Element im JFrame. Vorsicht: add(...) funktioniert für JFrame nicht! (Das ist nicht grade intuitiv, ist aber leider so.)

Layout

Jeder Container braucht ein Layout, in dem festgelegt wird, wie die Elemente im Container angeordnet werden.

• BorderLayout: Das BorderLayout legt fünf Regionen fest: BorderLayout.CENTER, BorderLayout.NORTH, BorderLayout.SOUTH, BorderLayout.WEST, BorderLayout.EAST. In jeder der fünf Regionen kann nur ein Element platziert werden; das kann aber auch ein JPanel oder ein andere Container sein.
• AbsoluteLayout: Dieses Layout ermöglicht es einem, die Elemente an Positionen zu platzieren, die man durch Koordinaten angibt (bzw. mit dem WindowBuilder zieht man die Komponenten an die passende Stelle.) Das ist praktisch, wenn man sicher weiß, dass die Elemente eine feste Größe haben.
• BoxLayout: BoxLayout ermöglicht, mehrere Elemente nebeneinander (X_AXIS) oder untereinander (Y_AXIS) zu platzieren.

Components

• JLabel: einzeilige Schrift; nicht editierbar.
• JTextField: einzeiliges Textfeld; editierbar.
• JTextArea: mehrzeiliges Textfeld; editierbar. Um Text in mehreren Zeilen anzuzeigen, muss man als Zeilenumbruch "\n" einbauen.
• JButton: ein Button. Um das Klicken abzufangen, muss an den Button ein ActionListener angehängt werden; das macht man am besten mit dem WindowBuilder.
• JCheckbox und JRadioButton: wichtig, um von vielen Möglichkeiten mehrere auszuwählen. Bei der JCheckbox kann man in der Regel mehrere anklicken; den JRadioButton benutzt man, wenn man von vielen Möglichkeiten nur eine wählen darf. Dafür müssen die JRadioButtons zu einer ButtonGroup hinzugefügt werden.

wichtige Methoden

• setText(String pText)
• getText()
• isSelected() nur für JCheckbox und JRadioButton

Eine Benutzeroberfläche sichtbar machen

"Selbstständig lebensfähig" ist von den genannten Klassen nur die Klasse JFrame.

D.h. wenn man eine Oberfläche sichtbar machen will, dann muss man am besten alles in einen JFrame packen. Dafür bietet sich folgendes Verfahren an:

• Das JFrame-Objekt enthält als Attribut ein Objekt, das von JPanel erbt.
• Dieses Objekt wird dem JFrame hinzugefügt.
  • WICHTIG: dafür muss this.getContentPane().add(...) aufgerufen werden!!!

Beispiel:

import javax.swing.JFrame;

public class MainFrame extends JFrame{

  private SimplePanel simplePanel;
  
  public MainFrame() {
      //simplePanel erzeugen
      simplePanel = new SimplePanel();
      //simplePanel hinzufuegen
      this.getContentPane().add(simplePanel);
      // mit pack kann man die Groesse des JFrame auf das notwendige Mass bringen
      this.pack();
      // sichtbar machen.
      this.setVisible(true);
  }
     
  public static void main(String[] args) {
      SimpleFrame sf = new SimpleFrame();
  }
}

Die Klasse SimplePanel ist hier nur für Demo-Zwecke aufgeführt.

import java.awt.BorderLayout;

import javax.swing.JLabel;
import javax.swing.JPanel;

public class SimplePanel extends JPanel {
   private JLabel dasLabel;
  
   public SimplePanel(){
       this.setLayout(new BorderLayout());
       dasLabel = new JLabel("test: dasLabel");
       this.add(dasLabel, BorderLayout.CENTER);
   }
}

Events und Listener

Events werden ausgelöst, wenn in der grafischen Oberfläche eine Eingabe o.ä. passiert. Das "klassische" Event ist das Klicken eines JButton.

Um auf ein Event zu reagieren, muss man an die entsprechende Komponente (z.B. den JButton) einen Listener hinzugefügt; dieser "hört zu", ob ein Event ausgelöst wird.

Standard-Beispiel für einen JButton:

• Hier wird ein ActionListener hinzugefügt;
• dieser hat die Methode public void actionPerformed(ActionEvent e).
• diese Methode wird aufgerufen, wenn der JButton geklickt wird.
• D.h. in die Methode public void actionPerformed(ActionEvent e) schreibt man rein, was passieren soll, wenn der JButton geklickt wird!

Beispiel: Das ButtonPanel muss noch einem JFrame hinzugefügt werden, damit es sichtbar gemacht werden kann; siehe oben.

import java.awt.BorderLayout;

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.swing.JButton;
import javax.swing.JPanel;

public class ButtonPanel extends JPanel{
 
  JButton derButton;
  
  public ButtonPanel() {
      setLayout(new BorderLayout());
      derButton = new JButton("groesser machen");
 
      // dem JButton einen ActionListener hinzufuegen
      // (der ActionListener ist in diesem Fall anonym)
      derButton.addActionListener(new ActionListener(){
 
           // diese Methode wird aufgerufen, wenn ein ActionEvent fuer den Button ausgeloest wurde.
           public void actionPerformed(ActionEvent e) {
              // hier jetzt die Methode aufrufen, die dann ausgefuehrt werden soll.
              vergroessern();
           }
      });
 
      this.add(derButton);
  }

  private void vergroessern(){
      this.setSize(this.getWidth()+10, this.getHeight()+10);
  }
}

JOptionPane

JOptionPane dient dazu, kleine Fenster aufzumachen, z.B. um eine Bestätigung oder Eingabe vom Nutzer abzufragen. Die Abarbeitung der aufrufenden Methode wartet so lange, bis der Nutzer das Fenster durch OK oder Abbrechen zugemacht hat.

wichtige Methoden

• JOptionPane.showInputDialog(String pFrage): Fragt eine Texteingabe vom Nutzer ab. Gibt einen String zurück.
• JOptionPane.showMessageDialog(Component parentComponent, String pMessage): Informiert den Nutzer über irgendetwas. parentComponent kann null sein. Gibt void zurück.
• JOptionPane.showConfirmDialog(Component parentComponent, String pFrage): Fragt nach einer Bestätigung (Ja, Nein, Abbrechen). parentComponent kann null sein. Gibt int zurück. Die möglichen Rückgaben sind:
  • JOptionPane.YES_OPTION
  • JOptionPane.NO_OPTION
  • JOptionPane.CANCEL_OPTION
  • Die Rückgaben überprüft man z.B. so:

int gewaehlt = JOptionPane.showConfirmDialog(null, "Nochmal?");
if(gewaehlt == JOptionPane.YES_OPTION)
{...}
else if (gewaehlt == JOptionPane.NO_OPTION)
{...}
else
{...}