Galileo Computing :: Java ist auch eine Insel

15.6 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.

15.6.1 Normale Schaltflächen (JButton)

Die Schaltfläche JButton reagiert auf Aktivierung und erzeugt ein ActionEvent, das ein angehängter ActionListener meldet.

Hier klicken, um das Bild zu vergrößern

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

Listing 15.12 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() { 
  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() { 
  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. [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, die durch die Schaltfläche ausgelöst werden, abgreift.

void removeActionListener( ActionListener l ) Entfernt den ActionListener wieder. Somit kann er keine weiteren Ereignisse mehr abgreifen. [Siehe dazu das Buch »Tog on Interface« von Bruce Tognazzini, auszugsweise unter http://www.asktog.com/TOI/toi06KeyboardVMouse1.html. ]

Hinweis Wörter mit einer starken emotionalen Bindung sollten vermieden werden. In englischen Programmen müssen Wörter wie »kill« oder »abort« umgangen werden.⁶

15.6.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) gesandt. 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.

Hier klicken, um das Bild zu vergrößern

interface java.awt.event.ActionListener 
extends EventListener

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

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

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 Alt-, Windows- oder Apfel-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.

15.6.3 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 – ein Zeichen, 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 setSelected-Icon(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 gedrückt 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 extra Icon möglich. Es wird mit setDisabledIcon() gesetzt. Dazu passt setDisabledSelectedIcon().

Hier klicken, um das Bild zu vergrößern

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 das 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 so genannte 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.

15.6.4 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.