15.12 Kontrollfelder, Optionsfelder, Kontrollfeldgruppen

Ein Kontrollfeld ist eine Komponente mit einem Zustand: »Ein« oder »Aus«. Der Zustand wird meistens als Rechteck oder Kreis neben einer Zeichenkette dargestellt. Kontrollfelder dienen dem Benutzer meistens als Auswahl von Optionen. Bei einer Pizza-Bestellung kann etwa ein Optionsfeld die Beläge anbieten. Hier würde ich dann immer Pilze, Paprika und Zwiebeln wählen.

In Swing sind zwei Klassen als besondere Schaltflächen vorgesehen, sodass der Benutzer aus einer Reihe von Optionen wählen kann: JCheckBox und JRadioButton. Beide sind Unterklassen von AbstractButton und haben daher die schon erwähnten Möglichkeiten für HTML-Text, unterschiedliche Grafiken, Abstand und so weiter.

15.12.1 Kontrollfelder (JCheckBox)

Die JCheckBox ist als Schaltfläche so flexibel wie ein JButton und lässt sich verschiedene Grafiken für den eingeschalteten und ausgeschalteten Zustand zuweisen. Dazu dienen die Methoden setIcon() und setSelectedIcon(). Diese Methoden kommen alle aus der Oberklasse AbstractButton. Im Konstruktor lässt sich als zweites Argument ein Wahrheitswert angeben, der bestimmt, ob das Feld am Anfang gesetzt ist oder nicht.

Ändert sich der Zustand eines Felds (Selektion oder Deselektion), wird ein ItemEvent an alle registrierten ItemListener weitergeleitet. Nach dem Anlegen des Objekts kann die Methode setState(boolean) den Status verändern. Das Argument true markiert die Option des Kontrollfelds. getState() liefert den aktuellen Status des Kontrollfelds (siehe Abbildung 15.13).

Abbildung 15.13 Kontrollkästchen für unsere Helden

Listing 15.29 com/tutego/insel/ui/swing/JCheckBoxDemo.java

package com.tutego.insel.ui.swing; 
 
import java.awt.BorderLayout; 
import java.awt.event.*; 
import javax.swing.*; 
 
public class JCheckBoxDemo 
{ 
  public static void main( String[] args ) 
  { 
    JFrame f = new JFrame( "Tolle Fernsehserien" ); 
    f.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE ); 
 
    Icon unchecked = new ImageIcon( JCheckBoxDemo.class.getResource(  
                                     "/images/cancel.png" ) ); 
    Icon checked   = new ImageIcon( JCheckBoxDemo.class.getResource(  
                                     "/images/ok.png" ) ); 
 
    JCheckBox cb1 = new JCheckBox( "Ein Colt für alle Fälle", true ); 
    cb1.setIcon( unchecked ); 
    cb1.setSelectedIcon( checked ); 
    f.add( cb1, BorderLayout.PAGE_START ); 
 
    JCheckBox cb2 = new JCheckBox( "MacGyver", false ); 
    cb2.setIcon( unchecked ); 
    cb2.setSelectedIcon( checked ); 
    f.add( cb2, BorderLayout.PAGE_END ); 
 
    // Listener für die Helden 
 
    ItemListener herosListener = new ItemListener() { 
      public void itemStateChanged( ItemEvent e ) { 
        System.out.print( ((JCheckBox) e.getItem()).getText() ); 
        System.out.println( e.getStateChange() == ItemEvent.SELECTED ?  
                            " selected" : " unselected" ); 
      } 
    }; 
 
    cb1.addItemListener( herosListener ); 
    cb2.addItemListener( herosListener ); 
 
    f.pack(); 
    f.setVisible( true ); 
  } 
}

15.12.2 ItemSelectable, ItemListener und das ItemEvent

In Swing gibt es eine Schnittstelle ItemSelectable, die alle Swing-Klassen implementieren, bei denen Einträge selektiert werden können:

interface java.awt.ItemSelectable

• void addItemListener( ItemListener l )

• void removeItemListener( ItemListener l )

• Object[] getSelectedObjects()

Folgende Gui-Komponenten implementieren diese Schnittstelle

• Alle von AbstractButton abgeleiteten Schaltflächen, insbesondere JCheckBox, JRadioButton, JCheckBoxMenuItem, JRadioButtonMenuItem

• JComboBox

ItemListener

Die Schnittstelle ItemListener wird von allen Objekten implementiert, die an einem Auswahlereignis interessiert sind. Wird ein Element ausgewählt, wird die Methode itemStateChanged() aufgerufen.

interface java.awt.event.ItemListener 
extends EventListener

• void itemStateChanged( ItemEvent e ) Wird aufgerufen, wenn ein Eintrag selektiert oder deselektiert wird.

ItemEvent an ItemListener

Dem Listener wird in itemStateChanged() ein ItemEvent-Objekt übergeben, das Zugriff auf die Komponente oder den Zustand liefert.

class java.awt.event.ItemEvent 
extends AWTEvent

• ItemSelectable getItemSelectable() Gibt ein ItemSelectable-Objekt von der Komponente zurück, die das Ereignis ausgelöst hat.

• Object getItem() Gibt das vom Ereigniserzeuger initialisierte Item zurück. Der Typ kann je nach Komponente unterschiedlich sein. (Die API-Dokumentation ist mit dem Satz »The item whose selection state has changed« relativ unspezifisch. Bei einer JCheckBox ist es jedenfalls nicht der String.)

• int getStateChange() Gibt den Status des Eintrags zurück. Die Klasse deklariert dazu die Konstanten Item-Event.SELECTED und ItemEvent.DESELECTED.

Innerhalb der Funktion itemStateChanged() bezieht wie üblich getSource() den Auslöser des Ereignisses. Es gibt aber noch einen zweiten Weg über die Methode getItemSelectable(). Das hat den Vorteil, dass die Rückgabe ein ItemSelectable ist, wobei eine Typanpassung entfallen kann, wenn etwa über die ItemSelectable-Methode getSelected-Objects() die selektierten Objekte erfragt werden sollen.

Ob nun eine Selektion oder Deselektion stattfand beziehungsweise wie der aktuelle Zustand ist, lässt sich wiederum über unterschiedliche Wege erfragen. Mittels der Objektmethoden getStateChange() von ItemEvent lässt sich der Wechsel (Selektion oder Deselektion) erfragen. Der Rückgabewert ist eine Ganzzahl, und wir sollten ihn mit den Konstanten Item-Event.SELECTED und ItemEvent.DESELECTED vergleichen. Der andere Weg geht über die Komponente selbst: Im Fall einer JCheckBox – und jeder allgemeinen Schaltflächen-Art, die Unterklasse von AbstractButton ist – ermittelt isSelected() den aktuellen Zustand.

15.12.3 Sich gegenseitig ausschließende Optionen (JRadioButton)

Wir müssen unterscheiden, ob sich Kontrollkästchen gegenseitig ausschließen oder nicht. Falls sie sich ausschließen, kann nur ein Kontrollfeld markiert sein. Bei sich nicht ausschließenden Feldern gibt es keine Beschränkung. Sind die Kontrollkästchen in einer Gruppe (Kontrollfeldgruppe) organisiert, werden sie auch Optionsfelder genannt. Der Name sagt es bereits: Eine Option kann gesetzt werden oder nicht – bei einem Druckdialog etwa ein Ausdruck in Farbe oder in Schwarzweiß.

Sich gegenseitig ausschließende Eingaben können die Swing-Komponenten JRadioButton und JComboBox realisieren. In diesem Abschnitt wollen wir uns mit JRadioButton beschäftigen.

Die ButtonGroup

Um die sich gegenseitig ausschließenden Auswahlknöpfe von den standardmäßig rechteckig gezeichneten JCheckBox-Objekten unterscheiden zu können, werden diese üblicherweise rund gezeichnet. Ohne Vorbereitung schließen sich die JRadioButtons allerdings nicht aus; hierfür wird ein spezielles ButtonGroup-Objekt verwendet, das die Selektionen überwacht. Werden die JRadioButton-Objekte erzeugt, lassen sie sich später einer ButtonGroup hinzufügen, sodass nur jeweils ein Element ausgewählt sein kann.

JRadioButton rb1 = new JRadioButton( "schwarz" ); 
JRadioButton rb2 = new JRadioButton( "weiß" ); 
rb1.setSelected( true ); 
ButtonGroup g = new ButtonGroup(); 
g.add( rb1 ); g.add( rb2 ); 
container.add( rb1 ); container.add( rb2 );

Abbildung 15.14 Beispiel für ein Optionsfeld

Listing 15.30 com/tutego/insel/ui/swing/JRadioButtonDemo.java

package com.tutego.insel.ui.swing; 
 
import java.awt.BorderLayout; 
import javax.swing.*; 
 
public class JRadioButtonDemo 
{ 
  public static void main( String[] args ) 
  { 
    JFrame f = new JFrame(); 
    f.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE ); 
 
    JRadioButton rb1 = new JRadioButton( "schwarz " ); 
    f.add( rb1, BorderLayout.PAGE_START ); 
    JRadioButton rb2 = new JRadioButton( "weiß" ); 
    f.add( rb2, BorderLayout.PAGE_END ); 
 
    rb1.setSelected( true ); 
 
    // Radio-Buttons auf die ButtonGroup setzen 
 
    ButtonGroup g = new ButtonGroup(); 
    g.add( rb1 ); 
    g.add( rb2 ); 
 
    f.pack(); 
    f.setVisible( true ); 
  } 
}

Mehrere Ereignisse über einen ItemListener

Wird ein ItemListener auf unterschiedliche Komponenten gleichzeitig angewendet, so ist es klug, mittels getSource() den Typ der Komponente zu erfragen und dann mit dem instanceof-Operator weiter zu untergliedern.

public void itemStateChanged( ItemEvent e ) 
{ 
  Object comp = e.getSource(); 
  if ( comp instanceof JCheckBox ) 
    ... 
  else if ( comp instanceof JRadioButton ) 
    ... 
  else if ( comp instanceof JComboBox ) 
    ... 
}

Ihr Kommentar