9.5 Schaltflächen

Eine Schaltfläche (engl. button) ermöglicht es dem Anwender, eine Aktion auszulösen. Schaltflächen sind meistens beschriftet und stellen eine Zeichenkette dar oder tragen eine Grafik, etwa im Fall eines Symbols in der Symbolleiste. Unter dem AWT kann eine Schaltfläche nur Text, aber keine Icons darstellen.

Swing kennt unterschiedliche Schaltflächen. Dazu zählen JButton für einfache Schaltflächen, aber auch Schaltflächen zum Ankreuzen.

9.5.1 Normale Schaltflächen (JButton)

Eine Schaltfläche (engl. button) ermöglicht es dem Anwender, eine Aktion auszulösen. Schaltflächen sind meistens beschriftet und stellen eine Zeichenkette dar oder tragen eine Grafik, etwa im Fall eines Symbols in der Symbolleiste. Unter dem AWT kann eine Schaltfläche nur Text, aber keine Icons darstellen. Die Schaltfläche JButton reagiert auf Aktivierung und erzeugt ein ActionEvent, das ein angehängter ActionListener meldet.

Abbildung 9.8: JButton mit einer einfachen Schaltfläche zum Schließen

Listing 9.14: com/tutego/insel/ui/swing/JButtonDemo.java, main()

JFrame frame = new JFrame();
frame.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
frame.setLayout( new FlowLayout() );

// Button 1

final Icon icon1 = new ImageIcon(
        JButtonDemo.class.getResource( "/images/user-trash-full.png" ) );
final Icon icon2 = new ImageIcon(
        JButtonDemo.class.getResource( "/images/user-trash.png" ) );

final JButton button1 = new JButton( icon1 );
frame.add( button1 );

ActionListener al = new ActionListener() {
  @Override public void actionPerformed( ActionEvent e ) {
    button1.setIcon( icon2 );
  }
};

button1.addActionListener( al );

// Button 2

final JButton button2 = new JButton( "Ende" );
frame.add( button2 );

button2.addActionListener( new ActionListener() {
  @Override public void actionPerformed( ActionEvent e ) {
    System.exit( 0 );
  }
} );

frame.pack();
frame.setVisible( true );

Die JButton-API

Es gibt mehrere Konstruktoren für JButton-Objekte. Die parameterlose Variante erzeugt eine Schaltfläche ohne Text. Der Text lässt sich mit setText() nachträglich ändern. In der Regel nutzen wir den Konstruktor, dem ein String mitgegeben wird.

class javax.swing.JButton
extends AbstractButton
implements Accessible

• JButton()
  Erzeugt eine neue Schaltfläche ohne Aufschrift.
• JButton(String text)
  Erzeugt eine neue Schaltfläche mit Aufschrift.
• JButton(Icon icon)
  Erzeugt eine neue Schaltfläche mit Icon.
• JButton(String text, Icon icon)
  Erzeugt eine neue Schaltfläche mit Aufschrift und Icon.
• void setText(String text)
  Ändert die Aufschrift der Schaltfläche auch im laufenden Betrieb.[67](Vergleichen wir das mit den Methoden der Klasse java.awt.Label. Hier heißen die Methoden zum Lesen und Ändern des Textes setLabel() und getLabel(). Dies ist für mich wieder eines der AWT-Rätsel. Warum heißt es bei einem java.awt.Label-Objekt setText()/getText() und bei einem java.awt.Button-Objekt setLabel()/getLabel()? Immerhin heißt es bei den Swing-Komponenten JLabel und JButton konsequent setText()/getText().)
• String getText()
  Liefert die Aufschrift der Schaltfläche.
• void addActionListener(ActionListener l)
  Fügt dem Button einen ActionListener hinzu, der die Ereignisse abgreift, die durch die Schaltfläche ausgelöst werden.
• void removeActionListener(ActionListener l)
  Entfernt den ActionListener wieder. Somit kann er keine weiteren Ereignisse mehr abgreifen.

9.5.2 Der aufmerksame ActionListener

Klicken wir auf die Schaltfläche, so sollte die Aktion gemeldet werden. Diese wird in Form eines ActionEvent-Objekts an den Zuhörer (einen ActionListener) gesendet. Ein ActionListener wird mit der Methode addActionListener() an die Objekte angeheftet, die Aktionen auslösen können. ActionListener ist eine Schnittstelle mit der Methode actionPerformed(). Die Schnittstelle ActionListener wiederum erweitert die Schnittstelle EventListener, die von allen Listener-Interfaces implementiert werden muss.

interface java.awt.event.ActionListener
extends EventListener

• void actionPerformed(ActionEvent e)
  Wird aufgerufen, wenn eine Aktion ausgelöst wird.

Abbildung 9.9: Die Beziehung zwischen ActionListener und ActionEvent

Werfen wir noch einmal einen Blick auf die Implementierung unserer beiden ActionListener-Klassen, die als anonyme innere Klasse realisiert sind:

ActionListener al = new ActionListener() {
  public void actionPerformed( ActionEvent e ) {
    button1.setIcon( icon2 );
  }
};

button2.addActionListener( new ActionListener() {
  public void actionPerformed( ActionEvent e ) {
    System.exit( 0 );
  }
} );

9.5.3 Schaltflächen-Ereignisse vom Typ ActionEvent

Wird ein ActionEvent ausgelöst, dann wird die Methode actionPerformed() aufgerufen. Wir sehen, dass als Argument ein ActionEvent übergeben wird.

class java.awt.event.ActionEvent
extends AWTEvent

• int getModifiers()
  Liefert den Umschaltcode für Tasten, die während des Ereignisses gedrückt waren, als Verknüpfung der Konstanten SHIFT_MASK, CTRL_MASK, META_MASK (etwa die -, - oder -Taste) und ALT_MASK. Diese Konstanten kommen direkt aus der Event-Klasse, so ist etwa ALT_MASK = Event.ALT_MASK. Außerdem gibt es die Konstanten ACTION_FIRST, ACTION_LAST und ACTION_PERFORMED, die aber alle für den gleichen Wert stehen.
• long getWhen()
  Liefert einen Zeitstempel, wann das Ereignis ausgelöst wurde.
• String paramString()
  Liefert einen Erkennungsstring für das Ereignis.

9.5.4 Basisklasse AbstractButton

Alle Schaltflächen haben in Java eine gemeinsame Oberklasse, die Eigenschaften wie Listener, Abstand Text/Icon und Weiteres bestimmt. Diese Oberklasse ist AbstractButton und ist Basis von:

• JButton
• JToggleButton
• JMenuItem (somit auch für die weiteren Unterklassen JCheckBox und JRadioButton)

Der AbstractButton ist, wie der Name schon sagt, eine abstrakte Klasse, die aus JComponent hervorgeht. Über die Oberklasse lassen sich die folgenden Eigenschaften für alle Schaltflächen steuern:

• Das Mnemonik-Zeichen – ein Kürzel, das im Text unterstrichen dargestellt wird und schnell über die -Taste aufgerufen werden kann. Dies übernimmt die Methode setMnemonic(char).
• Sich selbst auslösen durch doClick().
• Icons mit setDisabledIcon(Icon), setDisabledSelectedIcon(Icon), setPressedIcon(Icon), setRolloverIcon(Icon), setRolloverSelectedIcon(Icon) und setSelectedIcon(Icon) ändern.
• Die Ausrichtung von Text und Icon in der Schaltfläche durch setVerticalAlignment() und setHorizontalAlignment() bestimmen.
• Die Position von Icon und Text untereinander durch setVerticalTextPosition() und setHorizontalTextPosition() bestimmen.

Bilder auf Schaltflächen je nach Zustand *

Die Integration mit den Icon-Objekten liegt in der AbstractButton-Klasse. Geben wir im Konstruktor das Icon nicht an, so lässt sich dies immer noch über setIcon() nachträglich setzen und ändern. Wenn die Schaltfläche angeklickt wird, kann ein anderes Bild erscheinen. Dieses Icon setzt setPressedIcon(). Bewegen wir uns über die Schaltfläche, lässt sich auch ein anderes Icon setzen. Dazu dient die Methode setRolloverIcon(). Die Fähigkeit muss aber erst mit setRolloverEnabled(true) eingeschaltet werden. Beide Eigenschaften lassen sich auch zu einem Icon kombinieren, das erscheint, wenn die Maus über dem Bild ist und eine Selektion gemacht wird. Dazu dient setRolloverSelectedIcon(). Für JToggleButton-Objekte ist eine weitere Methode wichtig, denn ein JToggleButton hat zwei Zustände: einen selektierten und einen nicht selektierten. Auch hier können zwei Icon-Objekte zugeordnet werden, und das Icon der Selektion lässt sich mit setSelectedIcon() setzen. Ist die Schaltfläche ausgegraut, ist auch hier ein gesondertes Icon möglich. Es wird mit setDisabledIcon() gesetzt. Dazu passt setDisabledSelectedIcon().

Abbildung 9.10: Die Klasse AbstractButton und ihre Unterklassen

Den Erkennungsstring (Action-Command) einer Schaltfläche ändern *

Manche Ereignisbehandler für Schaltflächen sind einander so ähnlich, dass Entwickler nur einen Listener mit mehreren Schaltflächen verbinden möchten. Dann taucht nur das Problem auf, wie der Listener die Schaltflächen unterscheiden soll. Eine Idee wäre, die Beschriftung mit getText() auszulesen – was allerdings ein Problem mit sich bringt, wenn die Software stark landessprachlich ist, da sich bei mehrsprachigen Anwendungen die Aufschrift ändert. Eine andere Lösung bestünde darin, mit getSource() zu arbeiten. Dann müsste im Listener allerdings die Komponente für einen Vergleich verfügbar sein (was oft nicht der Fall ist).

Als Lösung bietet die AbstractButton-Klasse die Methode setActionCommand() an, mit der sich eine Kennung, der sogenannte Action-Command, setzen lässt.

abstract class javax.swing.AbstractButton
extends JComponent
implements ItemSelectable, SwingConstants

• void setActionCommand(String command)
  Setzt einen neuen Kommandostring, wenn das Ereignis ausgeführt wird.

Der Listener kann diesen Action-Command mit getActionCommand() aus dem ActionEvent auslesen.

class java.awt.event.ActionEvent
extends AWTEvent

• String getActionCommand()
  Liefert den String, der mit dieser Aktion verbunden ist.

Ohne explizites Setzen ist der Action-Command standardmäßig mit der Beschriftung der Schaltfläche initialisiert.

9.5.5 Wechselknopf (JToggleButton)

Ein JToggleButton (zu Deutsch Wechselknopf) hat im Gegensatz zum JButton zwei Zustände. Dies ist vergleichbar mit einem Schalter, der den Zustand »ein« oder »aus« annimmt. Der JButton gerät in diesen Zustand nur bei der Aktivierung, springt dann aber wieder in seinen ursprünglichen Zustand zurück. Der JToggleButton springt bei der ersten Aktivierung in einen festen Zustand und bleibt dort so lange, bis er wieder aktiviert wird. JToggleButton ist die Oberklasse für die Auswahlknöpfe JCheckBox und JRadioButton.

Ihr Kommentar

Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen.